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(54) Extensible distributed enterprise application integration system and methods of operating 
same 



(57) A system for integrating a plurality of computer 
applications has an enterprise messaging system, said 
enterprise messaging system passing messages 
between said computer applications. A database stor- 
age system coupled to said enterprise messaging sys- 
tem stores a plurality of data transformation 
configurations and a plurality of rules. An integration 
services is coupled to said enterprise messaging sys- 
tem, and comprises a data transformation engine using 
the data transformation configurations stored in said 
database storage system and a rules evaluation engine 

210 



using the rules stored in said database storage system. 
A plurality of agent-adapters are coupled to said enter- 
prise messaging system, each coupled to a respective 
one of said computer applications, each agent-adapter 
passing messages between said enterprise messaging 
system and said respective computer application. A 
message schema operates in conjunction with said 
agent-adapters to parse individual message elements 
from the computer applications. 
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Description 



[0001] The present invention is related generally to what has become known in the computing arts as "middleware" 
and more particularly to an extensible distributed system and methods of operating same to integrate applications of 
the type that are normally deployed across a networked enterprise. 

[0002] According to one observer, if the lifeblood of today's corporations is information, then their arteries are the 
.nter-applicat.on interfaces" that facilitate movement of data around the corporate enterprise. This has more recently 
become known as an "application network". 

[0003] For the typical organization, the application network has grown organically into a collection of ad hoc appli- 
cation integration programs. This menagerie has had a very serious impact on businesses as it increases the time for 
implementing new applications, prevents senior management from getting a clear picture of the business and. in short 
clogs the corporate arteries. In spite of the fact that application integration has become crucial to a competitive corpo- 
ration s survival, it has nevertheless been acceptable in the prior art to handcraft or "hack" custom code for such pur- 
poses at enormous long-term cost to the corporation. Long-term application integration decisions have, likewise been 
made at the lowest possible levels based solely on individual project criteria. Because of the decidedly difficult nature 
of these problems, an effective enterprise application integration (EAI) solution has yet to be found 
[0004] The advent of the Internet, client/server computing, corporate mergers and acquisitions, globalization and 
business process re-engineering, have together forced corporate information technology (IT) departments to continu- 
a ly seek out new, and often manual, ways to make different systems talk to each other - regardless of how old some 

m !?, SyStemS m3y b6 - the enSUinQ Cha0Sl inade£ l uate communications systems have had a debilitating effect on 
IT s abilities to move as fast as the business needs it to. 

[0005] Recent trends in IT have only exacerbated this problem by increasing - often by an order of magnitude - 
he amount of inter-application interfacing needed to support them. Most recently, enterprise applications have per- 
formed such unctions as data warehousing and enterprise resource planning (ERP), and facilitated electronic com- 
merce. A brief rev,ew of these three technologies would, therefore, be helpful in understanding the long-felt but as yet 
unresolved need for EAI. M y 

[0006] Data warehousing techniques require large volumes of clean historical data that must be moved on a reg- 
ular basis, from many operational systems into the warehouse. Source data is usually structured for online transactional 
processing (OLTP), while the typical data warehouse also accommodates online analytical processing (OLAP) formats 
™«™ » 6 S0Ur ° e da ' a mUSt Under9 ° eX,enSlVe a 99'egation and reformatting as it is transferred to the warehouse' 
0007] A typical data warehouse according to the prior art is populated in four steps: (a) extracting the source data- 
(b) cleaning such extracted data; (c) aggregating the cleaned, extracted data in a number of dimensions; and (d) load- 
ing the warehouse. Each warehouse source requires the building of a specific data extraction, cleansing, aggregation 
and load routine. Forester Research estimates that the average large company has approximately four data ware- 
houses. In two years, it is expected that this number will grow to six. The average amount of data contained in each 
warehouse is also expected to double in size in that same period -from about 130 gigabytes to about 260 gigabytes 
* Pr ° associated wi,n such 'arge amounts of data growing at an ever-increasing pace is exacer- 
bated by the quality of source data. According to a study conducted by the META Group, typical data warehouses are 
being loaded today with as much as 20% poor quality data. That same study indicates that about 70% of its respond- 
ents used extraction, cleansing and loading processes that were coded by hand. With respect to the required aggrega- 
tion Processes, anecdotal evidence also reveals that as much as 50 hours of computer time may be required to 
complete this function alone. It is readily apparent that significant maintenance efforts would be involved with programs 
coded in such a manner. B 

L 0 , 0 ^ „ 0 " the ° ther hand ' ,ypiCal ERP SyStems (such as ,ne R/3 surprise application developed by SAP AG of 
Walldorf. Germany, as well as those developed by PeopleSoft, Oracle, and Baan) are essentially large, integrated pack- 
aged appl.cat.ons that support core business functions, such as payroll, manufacturing, general ledger, and human 
resources. Large corporations find it particularly attractive to buy such software solutions from a single source since it 
can cost between 10 to 20 times more to develop the same functionality in-house than to purchase it. Implementing an 
bKP system, however, can be an overwhelming process for a number of reasons. 

[0010] First and foremost, the corporation is buying a product and not building a solution. This means that business 
units within the corporation must adapt to the product and how it works, not the other way around. Furthermore today's 
ERP systems cannot replace all of a corporation's custom solutions. They must, therefore, communicate effectively with 
other legacy systems in place. Finally, it is not atypical for a corporation to employ more than one and completely differ- 
ent ERP system because a single vendor cannot usually meet every organizational need 

[0011] As a result, the options for getting data into and out of an ERP system preclude known approaches used for 
data warehousing. Each ERP system has a proprietary data model that is constantly being enhanced by its vendor 
Wnting extract or load routines that manipulate such models is not only complicated, but is also discouraged by the ven- 
dor since data val.dation and business rules inherent in the enterprise application are likely to be bypassed Instead 



EP 1 016 989 A2 



10 



ERPs require interaction at the business object level which deals with specific business entities such as general ledg- 
ers, budgets or accounts payable. Further details regarding implementation and use of one well-known and widely 
accepted ERP system may be found in S pecial Edition Using SAP R/3 (2d ed.), ISBN: 0-7897-1351-9, by Que Corpo- 
ration (1997). 

[0012] Electronic commerce in one form or another has been around for many years. In essence, it got its start with 
electronic data interchange (EDI). EDI permitted companies to communicate their purchase orders and invoices elec- 
tronically, and continued to develop such that today's companies use EDI for supply chain management. However, not 
until the more recent exploding use of online Internet websites to buy. sell, and even auction, items of interest has there 
been such a dire need for robust, effective EAI. See, e.g., U.S. Patent No. 5,627,972. 

[0013] Applications get developed in order to accomplish a specific business objective in a measured time frame. 
In a typical large organization, different teams of people using a wide assortment of operating systems, DBMSs and 
development tools develop hundreds of applications. In each case, the specific requirements are satisfied without 
regard for integration with any other applications. 

[0014] Several powerful trends are driving the market for application integration. For example, significant develop- 
15 ments in peer-to-peer networking and distributed processing have made it possible for businesses to better integrate 
their own functional departments as well as integrate with their partners and suppliers. The aforementioned Inter- 
net/"! ntranetTextranef explosion is also fueling the demand for a new class of "human active" applications that require 
integration with back-end legacy applications. Tremendous growth around the world in the adoption of enterprise appli- 
cation software packages {e.g.. SAP R/3) also requires integration with back-end legacy applications. Finally, message 
20 oriented middleware (MOM) — products such as IBM's MQSeries message queuing product — are becoming increas- 
ingly popular. Once customers realize the benefits of simple one-to-one application connectivity with MOM, their inter- 
est in many-to-many application integration increases significantly. 

[0015] As the need for businesses to integrate grows, the number of IT dollars spent on integrating applications is 
increasing rapidly. According to various industry analysts, the need for "mission critical" application integration will drive 

25 the combined market for MOM and "message brokers" to grow from $300 million in 1997 to over $700 million in 1999. 
According to an IBM survey of larger customers, nearly 70% of all code written today consists of interfaces, protocols 
and other procedures to establish linkages among various systems. Savvy IT executives can clearly see the dollar sav- 
ings to be gained by acquiring off-the-shelf software to satisfy as much of this requirement as possible. 
[0016] A message broker is a software hub that records and manages the contracts between publishers (i.e., send- 

30 ers) and subscribers (i.e., receivers) of messages. When a business event takes place, the application will publish the 
message(s) corresponding to that business event. The broker reviews its lists of subscriptions and activates delivery to 
each subscriber for that message type. Subscribers receive only the data to which they subscribe. A message pub- 
lished by one application can be subscribed to by multiple consumer applications. Similarly, a subscribing application 
can receive messages from multiple publishing applications. 

35 [0017] Before applications can publish or subscribe to messages, they must register their interest with the broker. 
There are two basic and different methods for applications to register interest in a message type — subject-based 
addressing and message-content filtering. In subject-based addressing, the broker uses the subject to identify and 
route the message to all parties expressing interest in that subject. The subject is a word used to describe the contents 
of the message. For example, a subject of the name "nr. emp. new," could serve to distribute information (e.g., name, 

40 address, employee number, etc.) on a newly hired employee. In message content routing, on the other hand, subscrip- 
tions are made based on the contents of fields within the message. The subscriptions can be based upon the message 
type and/or specific selection criteria relative to a field within the message. For example, a loan approval application 
could subscribe to all purchase orders over $1 00,000. 

[0018] One advantage to having two publish/subscribe paradigms is that the need to address messages to individ- 
45 ual subscribing applications is avoided. Additionally, new subscribing applications can be added without any changes 
to the publishing application. 

[0019] The typical publishing/subscribing broker uses a robust delivery vehicle for the actual distribution of mes- 
sages between applications. As mission critical messages travel over a combination of external and internal networks, 
the systems software ensures that messages are never lost or duplicated in the event of network failures. More often 

so than not, an asynchronous message delivery capability is provided which uses store-and-forward message queuing. In 
this paradigm, the queue-to-queue transfer takes place in pseudo-real time when the subscribing application is availa- 
ble. If the subscribing application is unavailable, the message is stored in a persistent queue for later delivery. 
[0020] To be effective, the message delivery vehicle must include a business transaction coordination function. A 
business transaction is typically made up of several units of work. Each and every unit of work must complete in order 

55 for the transaction to occur. If even one unit of work fails, the whole transaction fails, and all completed units of work 
must then be reversed. These transactions are long running and require message-based updates to multiple data- 
bases. The business transaction coordination function provides this managerial support. 

[0021] Two other important components are the rules-based engine and the data-transformation component. The 
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critical operations of a business could come to a grinding halt. 

[0033] Another problem with distributed hubs is the difficulty of managing the message broker complex. Because a 
message broker integrates so many different business applications into a few consolidated hubs, the talent and exper- 
tise required to manage and administer a message broker complex may be unattainable. 
5 [0034] The potential risk exposure is large whenever technology is applied to mission critical transaction processing 
applications of an enterprise. One problem for message brokering is that it manipulates mission critical information. In 
relative terms, message brokering is fairly new. However, while some early adopter companies have had great success 
with the concept of message brokering, much more is needed before message brokers and EAI can enter the main- 
stream. 

10 [0035] In the 1980's software systems development concentrated on the ability of heterogeneous systems to com- 
municate with each other. This was, in large part, due to the proliferation of proprietary communication protocols. Any 
newly developed system had to either comply with the application and data formats in place for the systems with which 
it wished to connect or communicate, or provide such application a specific translation. Accordingly, all software was 
customized to a greater or lesser degree. 

15 [0036] In today's rapidly changing environment, the concerted efforts of thousands of developers worldwide are 
focused on developing a system that satisfies the need for disparate applications to communicate with each other, with- 
out the necessity of embedding multiple, customized application-specific translation schemes. This as yet unfulfilled 
need is grounded in the imperative of the global economy. 

[0037] Accordingly, it is a general object of the present invention to provide systems and methods for integrating 
20 enterprise applications, which at the same time provide comprehensive management of such enterprise applications, 
including centralized monitoring, operation and configuration. 

[0038] It is a more specific object of the present invention to provide an agent-adapter architecture and message 

schema, which together improves message tracking and manipulation in such systems and methods. 

[0039] Another object of the present invention is to provide in such systems and methods enhanced security fea- 

25 tures, including such aspects as authentication, authorization, privacy, non-repudiation, and auditing. 

[0040] Still another object of the present invention is to provide systems and method for integrating enterprise appli- 
cations that include means for disaster recovery, fail-safe rollover, message replay and dual-site logging. 
[0041] It is also an overall object of the present invention to facilitate fast and simple integration of leading ERP 
applications, custom/legacy applications, packaged applications, and databases. More specifically, it is also an object 

30 of the present invention to reduce or substantially eliminate the need for the expensive custom coding that is tradition- 
ally required to integrate applications. 

[0042] Another object of the present invention is to provide an EAI system, which has a distributed architecture that 
facilitates the long-term reliability, scalability, flexibility, and extensibility needed by today's enterprises. 
[0043] Still another object of the present invention is to provide an EAI system, which increases an enterprise's 
35 return on investment by enabling the enterprise to leverage its existing IT investments, increase its speed to market, 
implement solutions and realize benefits more quickly, and reduce its operational costs. 

[0044] Yet another object of the present invention is to provide an EAI system, which provides faster access to an 
enterprise's customer and billing information so that the enterprise can service its customers more effectively and effi- 
ciently, creating stronger, more effective relationships. 
40 [0045] A further object of the present invention is to provide an EAI system with many-to-many points of integration, 
which substantially eliminates the concerns of conventional hub-and-spoke systems and their single-point-of-failure 
risks. 

[0046] Still a further object of the present invention is to provide an EAI system, which simplifies an enterprise IT 
architecture by providing a central point of integration for virtually all applications and platforms. 
45 [0047] Yet a further object of the present invention is to provide an EAI system, which provides efficient and cost 
effective information sharing. 

[0048] The methods, apparatus, and articles of manufacture described herein will achieve the above and other 
objects, advantages, and novel features according to the present invention, while avoiding the problems described 
herein above. 

50 [0049] In accordance with one important aspect of the present invention, the method comprises computer-imple- 
mented means for passing messages between a first computer application and a second computer application. Such 
method generally includes the steps of: (a) providing a first message having a first data structure from the first computer 
application: (b) publishing the first message to obtain a first published message: (c) converting the first data structure 
of the first published message to a second data structure to obtain a second message; (d) publishing the second mes- 

55 sage to obtain a second published message; and (e) providing the second published message to the second computer 
application. 

[0050] According to another important aspect of the present invention, the apparatus comprises a system for inte- 
grating a plurality of computer applications. Such apparatus generally includes means for routing messages within the 
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Fig. 7 shows a other objects according to the present invention; 

Fig. 8 illustrate a typical transformation process used in accordance with the present invention; and 
Fig. 9 further illustrates the transformation process shown in Fig. 9; 

Figs. 10(a) and 10(b) illustrate the advantage of message hubs according to the present invention; 
5 Figs. 11(a) through 11(c) depict various operating environments in which nodes and services according to the 

present invention are managed; 

Fig. 12 is a block diagram illustrating system services according to the present invention; 

Fig. 13 is a flowchart illustrating the steps necessary to create a message in accordance with the present invention 
without converting raw data; 

10 Fig. 14 is flowchart illustrating the steps necessary to create a message in accordance with the present invention 
by converting raw data; 

Fig. 15(a) illustrates one method of creating a message from an application to a message instance in accordance 
with a first embodiment of the present invention; 

Fig. 15(b) illustrates one method of creating a message from an application to a message instance in accordance 
15 with a second embodiment of the present invention; 

Fig. 15(c) illustrates one method of creating a message from an application to a message instance in accordance 
with a third embodiment of the present invention;; 

Fig. 15(d) illustrates one method of creating a message from an application to a message instance in accordance 
with a fourth embodiment of the present invention; 
20 Fig. 16 is a first class diagram according to the present invention; and 
Fig. 17 is a second class diagram according to the present invention. 

The Enterprise Computing Runtime Environment 

25 [0055] Referring now to the drawings, wherein like reference characters or numerals designate like or correspond- 
ing parts throughout each of the several views, there is shown in Fig. 1(a) a simplistic view of an enterprise computing 
runtime environment 10. Typical runtime environments 10 use a plurality of packaged software applications, including 
"back-office" applications 20 for enterprise resource planning (ERP) and "front-office" applications 30 for customer rela- 
tionship management (CRM), one or more customized legacy systems 40, and one or more multi-dimensional/rela- 

30 tional database management systems (RDBMS) 50. 

[0056] Throughout the past few decades, business enterprises have designed or bought many large, single-pur- 
pose software applications. These "legacy" applications continue to be used, and most often were designed to perform 
a specific function (e.g., inventory, finance, accounting, sales force automation, and human resources). More recently, 
substantial investments have also been made by those same enterprises to procure packaged software applications 

35 from software developers such as SAP, PeopleSoft, Oracle, and Baan. Each of these packaged software applications 
enjoyed its own unique strengths. Accordingly, the typical business enterprise used two or more disparate packaged 
software applications in the same runtime environment. Such packaged software applications were not, in the begin- 
ning, designed to share information among themselves. As a result, enterprises had been forced to integrate their dis- 
parate packaged software applications with expensive custom code. Such integration efforts often took months, if not 

40 years, to complete. 

[0057] Enterprise application integration (EAI) systems, such as the system 100 shown in Fig. 1(a), therefore, 
became a necessity. However, unlike EAI systems according to the prior art, system 100 comprises a solutions-oriented 
middleware, which facilitates its users to modify and fully integrate information residing within disparate applications 
through a single, common infrastructure. It allows the user to move information seamlessly, transparently, and quickly 

45 among employees, customers, and suppliers, to achieve maximum productivity. 

[0058] In such a manner, system 1 00 provides a reliable store-and-forward messaging system, a capable message 
brokering facility, and a strong agent-adapter architecture for integrating disparate enterprise applications. It is adapted 
to be distributed, and is designed for easy administration and management. It is targeted to meet the complete, heter- 
ogeneous computing requirements of a large organization. It intelligently links various applications so they can access 

so and share information. It is middleware that adapts to applications, rather than forcing applications to adapt to it. 

[0059] System 100 solves most EAI problems by enabling its users to link ERP applications 20, packaged applica- 
tions 30, custom and legacy applications 40, and databases 50 throughout the enterprise, with minimal custom coding. 
When fully integrated, an enterprise can quickly synchronize global businesses and divisions and respond to ever 
changing market demands. With faster access to customer and billing information, the user's organization can service 

55 customers more effectively and efficiently, creating stronger, more effective relationships. System 1 00 is a business- 
centric enterprise integration solution, with an integration flow design environment that targets the business analyst. 
The analyst defines the problem in business terms, and the product handles the technical issues. 
[0060] For example, as shown in Fig. 1 (b), the common scenario of enterprise resource planning (ERP) integration 
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[0077] "Delimiters" are tokens or markers that separate data fields in data from enterprise applications. 
[0078] A "durable subscription" is a property of the system's message hubs that ensures the hub target objects 
receive all messages intended for them. If a target object becomes inactive, the system remembers those messages, 
which the target has received. When the target next becomes active, the system delivers messages the target has not 
5 yet received. 

[0079] "Enterprise applications" are applications from which adapters extract data or to which adapters propagate 
data (e.g., SAP R/3 or MQSeries). 

[0080] An "Enterprise Messaging Service (EMS)" according to this invention is implemented using the Java Mes- 
saging Service (JMS). It enables system 100 to use multiple messaging modes, and supports message hubs and pro- 
10 vides message persistence. 

[0081] "Enterprise Resource Planning (ERP)" applications provide a turnkey solution (e.g., warehouse manage- 
ment, human resource management, and materials management) for common business problems. Examples of ERP 
products are SAP R/3, PeopleSoft, and Baan. 

[0082] An "EntireX Broker (ETB)" is a cross-platform, message-oriented middleware according to this invention, 
15 which links mainframe, Windows NT, and UNIX applications and components. Internet and intranet clients, and 
ActiveX- and Java-enabled workstations. 

[0083] "Filter definitions" are definition objects that specify criteria for screening messages out of integration flows. 
[0084] A "functions host" is a computing platform, such as a Windows NT server or workstation, or OS/390 main- 
frame. 

20 [0085] "Hubs" are integration flow objects that receive messages from source objects and hold the messages until 
the system 100 delivers them to specified target objects. Hubs allow adapters and transformers to exchange messages 
asynchronously. They are also useful for concentrating message flows; multiple objects that produce the same kind of 
message can all send those messages to one message hub. which simplifies links among objects 
[0086] An "IDoc Extractor" reads flat files produced by the SAP R/3 transaction WE63 to create implementation 

25 configurations and message definitions and stores them in the system's repository service. 

[0087] "Implementation settings" are runtime parameters for adapters (e.g., a polling interval). 
[0088] An "integration flow" is a series of linked system objects that move data from one or more enterprise appli- 
cations to other enterprise applications. 

[0089] "Integration objects" are integration flow objects, which send messages, receive messages, or both. See. 
30 e.g., adapters, hubs, and transformers. 

[0090] An "integration workbench" is a graphical user interface (GUI) through which a user designs integration 
flows. 

[0091] "Intermediate documents (IDocs)" is an SAP R/3 data format used by R/3 to exchange data with other R/3 
systems and with other applications. 
35 [0092] An "item message element" is a message element that contains data. Items are the lowest level message 
elements in the hierarchy of the message definition. They cannot contain other message elements. 
[0093] "Java Database Connectivity (JDBC)" is the Java API standard for SQL-based database access. 
[0094] A "Java Development Kit (JDK)" is a software development environment for writing applications in the Java 
programming language. 

40 [0095] "Java Message Service (JMS)" is a Java API specified by Sun Microsystems for messaging. 

[0096] A "Java Naming and Directory Interface (JNDI)" is a set of APIs that assist with the interfacing to multiple 
naming and directory services. 

[0097] "Java Runtime Environment (JRE)" is a subset of the Java Development Kit used to redistribute the runtime 
environment consisting of the Java virtual machine, Java core classes, and supporting files. 
45 [0098] A "Java virtual machine (JVM)" is part of the Java Runtime Environment responsible for interpreting byte- 
codes. 

[0099] "Link markers" are tokens or delimiters that separate data fields in data from enterprise applications. 
[0100] A "message definition category" is a logical grouping for message definitions. 

[0101] "Message definitions" are definition objects, which identify data system 100 is to extract from or propagate 
so to an enterprise application. Message definitions also define how system 100 is to construct system messages from 
enterprise application data or create enterprise application data from system messages. 

[0102] A "message element" is a data object that makes up the message schema of a message definition. Mes- 
sage elements are arranged in a hierarchical structure, and can be sections, tables, or items. 

[0103] "Message-Oriented Middleware (MOM)" is software that uses messages to enable applications on the same 
55 or different platforms to communicate. Communications protocols are hidden from the applications. Examples of MOMs 
are MQSeries, EntireX Broker, and JMS. 

[0104] "Message persistence" relates to the storing of messages onto recoverable media. The system writes each 
message it delivers from one integration object to another to stable storage in a location the user specifies. If a system 
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data to output messages. 

[0130] "Transformer definitions" are definition objects that define how the system is to transform system messages 
extracted from one or more enterprise applications into system messages needed by other enterprise applications. 
[0131] A "transformer" is an integration object that implements transformer definitions. Transformers gather input 
5 messages from source integration objects, transform the content and format of the message data, and produce and 
send output messages to target integration objects. 

[0132] "User interface services (UIS)" provide the user interface facilities necessary to run the client components 
(i.e., the integration workbench 120 and the administration console 160). 

[0133] Referring now to Fig. 2, system 1 00 generally comprises a plurality of design components 1 1 0 and a plurality 
10 of runtime management components 1 50. The design components 1 1 0, in turn, more specifically comprise an integra- 
tion workbench 120, an adapter development kit (ADK) 130, and a repository service 140. The runtime management 
components 150, in turn, more specifically comprise an administration console 160, an integration server 170, including 
an enterprise messaging engine 180, a node services component 190, a plurality of intelligent agent-adapters 200. 
[0134] The integration workbench 120 generally comprises a graphical modeling and configuration tool for integra- 
ls tion project development. It is used to define events, those messages associated with such events, integration flows, 
and business rules associated with such integration flows, as well as to identify those agents that publish and subscribe 
to the defined events. In addition, the integration workbench 120 provides diagnostics for consistency checking and 
testing integration flows. 

[0135] The ADK 130 is used to configure and generate customized intelligent agent-adapters 200. Shown in 
20 greater detail in Fig. 3. ADK 130 generally comprises an object framework including class libraries 132, wizards 134, 
and templates 136. The ADK 130 generates objects that can be accessed from conventional development tools. While 
system 100 includes a plurality of standard intelligent agent-adapters 200 for a wide range of applications and 
resources, there may be specific applications for which there is no such standard intelligent agent-adapter 200. In that 
event, ADK 130 further permits a custom, intelligent agent-adapter 200 to be built by those developers who are more 
25 familiar with the published interfaces that are provided by the target application environment. 

[0136] The repository service 140 generally comprises a relational database, which contains all of the specifica- 
tions for system 100, meta-data, and message broker service rules, and an interface to that relational database. 
[0137] The administration console 160 is used to configure and manage the runtime environment of system 100, 
and generally comprises a graphical console. It serves as a control point for system configuration, maintenance, mon- 
30 itoring, and diagnostics. Through the administration console 160, each of the individual components of system 100 are 
managed, including comprehensive services such component initiation and termination, and built-in software distribu- 
tion. 

[0138] The integration server 1 70 implements intelligent messaging by triggering and executing integration flows to. 
process events. It executes static and dynamic context sensitive rules that evaluate, modify, and route event data. As 
35 noted herein above, integration server 1 70 includes the enterprise messaging engine 1 80 comprising a distributed mes- 
saging subsystem, which manages all event data. It is, on the one hand, a key component of system 100. On the other 
hand, it is largely transparent to any user of system 100, and generally operates behind the scenes. It supports full per- 
sistence, once-and-only-once message delivery, and an in-memory mode for non-critical, high volume message 
requirements. 

40 [0139] The node services component 190 manages start/restart recovery, exception handling, and dynamic config- 
uration of system 100. It provides facilities for automated system installation and remote management across all partic- 
ipating clients and servers. Moreover, it is readily capable of installing and updating components remotely. 
[0140] As noted herein above, the plurality of intelligent agent-adapters 200 include not only those standard intelli- 
gent agent-adapters 200 that are distributed with system 100, but also those custom intelligent agent-adapters 200 that 

45 are developed by ADK 1 30. Each such intelligent agent-adapter 200, regardless of its type, generally comprises a runt- 
ime interface module connecting a particular one of the external application resources 300 to system 100. 
[0141] Referring for the moment to Figs. 4(a) and 4(b), it may be appreciated that such intelligent agent-adapters 
200, in accordance with a particularly important aspect of the present invention, combine the functionality of autono- 
mous agents with adapter technology. The agent component 210 acts as an independent software process, which 

so hosts one or more adapter components 220 (Fig. 4(a)), or 222 and 224 (Fig. 4(b)). It encapsulates sophisticated func- 
tionality such as store and forward caching, filtering, resource pooling, and scheduling. 

[0142] A primary advantage of this agent-adapter architecture is its ability to host complex business logic in order 
to maintain state and negotiate transactions with the application resources 300. This ability may be thought of as "con- 
versational mode processing", which is particularly critical when integrating application resources 300 of a transactional 
55 nature. More often than not, data elements that may be required for brokering messages from such application 
resources 300 are deeply nested within sub-transactions. These deeply nested data elements can, thus, be obtained 
only by engaging in a conversation with the transactional application resource 300. Otherwise "primitive" adapters, 
which have been used in the past, do not adequately address the complex behavior of transactional application 
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resources 300. 
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[01 53] A filter definition object 51 6 defines criteria that the system 1 00 will use to filter unwanted system messages 
put of integration flows. In an integration flow that transforms new customer data into invoices, for example, one filter 
definition object 516 that might be useful would be one in which system messages about customers who have already 
paid would be filtered out. 

5 [0154] Integration objects 530, of which there are three basic types, actually send or receive system messages. 
The three basic types of integration objects 530 are: (1) an adapter 220; (2) a message hub 518; and (3) a transformer 
520. Furthermore, and as noted briefly herein above, there are four basic types of adapters 220; (a) source adapters 
222; (b) target adapters 224; (c) reply adapters 226; and (d) request adapters 228. 

[0155] A source adapter 222 extracts the data from a source enterprise application, constructs system messages 
10 from that data, and sends those system messages to other integration objects 530 {e.g., message hub 518). A target 
adapter receives system messages from other integration objects 530 (e.g., transformer 520 through filter definition 
object 516), creates application data from those system messages, and propagates that data to a target enterprise 
application. A reply adapter 226 replies to requests for data from some other integration objects 530 by extracting the 
data from the applications, and then sending it to the requesting object 530. 
15 [0156] In general, message hubs 518 are used to receive system messages from one or more source integration 
objects 530, and to hold those system messages until the system 100 can deliver same to one or more target integra- 
tion objects 530. 

[0157] Transformers 520 are generally used to implement transformer definitions in three steps. They first gather 
system messages from source integration objects 530 (e.g., message hub 518). After the gathering step, they next 
20 transform the content and format of the data contained within such system messages. They finally produce and send 
output system messages to target integration objects 530 (e.g., target adapter 224). 

[0158] Message definitions 512 are the primary objects around which the integration flow 540 according to the 
present invention is built. When a user creates an integration flow, a message definition is assigned to every object 510, 
530 in that flow. A message definition 512 not only identifies the kind of system message that the object 510, 530 is to 

25 handle, but it also defines the hierarchical structure or schema of that system message. 

[0159] For example, a message definition 512 must be assigned to every source adapter 222 in the user's integra- 
tion flow 540. Each source adapter 222 knows what kind of message it is to produce, based on the message definition 
51 2 the user has assigned to it. Adapters 220, hubs 51 8, and filters 51 6 handle just one message definition 51 2. Trans- 
former definitions 514 and transformers 520, on the other hand, are capable of handling multiple message definitions 

30 512, as inputs and outputs. 

[0160] Some applications can create the Java data types that the system 100 supports. In those cases, the source 
adapter 222 can extract the data types specified in its message definition 512 and store them directly in a system mes- 
sage. Likewise, a target adapter 224 can retrieve the data types from a system message and insert them directly into 
the application (e.g., a target enterprise application 549). Other applications use a well-defined message format to 

35 describe the layout of their native data. In those cases, the message definition 512 for a source adapter 222 must 
include instructions for creating Java data types from the application data. Similarly, the message definition 512 for a 
target adapter 224 must include instructions for creating application data from the system Java objects. 
[0161] A special kind of message definition 512 is used by integration objects 530 to request data from other the 
system objects 510, 530. For example, message definitions 512 can also specify message validation criteria. System 

40 1 00 uses this criteria to determine whether system messages produced by adapters 220 and transformers 520 contain 
valid data (e.g., where the user includes a message definition 512 defining messages, which contains employee payroll 
information). The user, accordingly, may prevent inaccurate salary data from entering the system 100. If the message 
definition 512 contains an item element "Salary", for example, the user could then define validation criteria for the item 
stating that the message is valid only when the value in "Salary" is a positive number. The user may organize related 

45 message definitions 51 2 into logical groups called message categories. Suppose, for example, that the user is integrat- 
ing three applications using the system 100. The user might group the messages in the user's project into three mes- 
sage categories, one for each application. 

[0162] It should be noted at this juncture that the particular message schema 600 of a message definition 512 is 
made up of data objects, called message elements, which are arranged in a hierarchical structure as shown in Fig. 6. 

so In general, a message schema 600 comprises one or more sections 620, one or more tables 640, and one or more 
items 660. Either a section 620 or a table 640 must appear at the top of message 600 hierarchy. 
[0163] A section 620 is a non-repealing group of message elements. Such section elements do not themselves 
contain actual data. Instead, they contain other message elements that contain data (i.e., they contain items 660). Sec- 
tions 620 can contain any combination of message element types. 

55 [01 64] A table 640 is a group of section elements, called rows that can repeal any number of times. Table elements 
also do not contain actual data. They contain other message elements that contain data (i.e., they contain items). 
Tables 640 can contain any combination of message element types. 

[0165] An item 660 is a message element that contains data. Items 660 are the lowest level message elements in 
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can also use the ADK 130 to create custom adapters 220 for applications not currently supported by the system 100 
Likewise, the user can use the ADK 130 to create custom adapters 220 that connect to any applica ton wim a JAVA 
application programming interface (API). 

[0169] To use a standard or custom adapter 220 in an integration flow 540. the user must configure in to handle a 
specific message def,n,t,on 512. The user can configure as many of each type of adapter 220 as neceL^v to handle 
all messages the user need to include in integration flows 540 necessary to handle 
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[0171] Target adapters 224 receive messages from other the system objects 510. 530 in integration flows 540 and 
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?AP R/3 aa 0 p r nT amP • ^ USer o Wan ' S t0 integr3,e three SAP m sys,ems with ona RDBMS, the user needs three 

11 T ! k 1 ' 68 RDBMS 39ent S6rViCe - Each a9ent service hos, s aN adapters 220 for the enterpr se 

application to which the agent connects. enterprise 

[0176] Transformer definitions 514 define a process that transforms messages containing data extracted from one 

IZZTSfT in 'r 6353965 C ° ntaining d3 ' 3 ne6ded by ° ne ° r m0re a PP' icati °- TrLZeTSoZelZ 
transformer definitions 514 by gathering input messages from source objects, transforming the data, and sending out! 
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put messages to target objects. 

[0177] The transformation process defined in a transformer definition 514 always involves at least two kinds of mes- 
sages: the primary input message, and one or more output messages, as shown in Fig. 8. The primary input message 
typically contains most or all of the data the user want to send in output messages to the target applications. Output 

5 messages contain data from the input messages, transformed as necessary for target applications. 

[0178] When the user creates a transformer definition 514, the user first specifies at 805 the name of the primary 
input message. Then, at 810, the user identifies the message definition 512 that defines the messages the user wants 
to use as the primary input. Any supporting input messages are then specified at 815. Next, the user identifies at 820 
the message definitions 512 that define such supporting input messages. A single transformation process can produce 

w any number of outputs. Accordingly, the user must specify those output messages at 825, and identify the message def- 
initions 512 that define the messages the user want to produce as outputs. 

[0179] The user then creates, beginning at 835, a sequence of steps 840, 845. 850. 855, 860, 865 that define when 
to read input data, how to transform the input data, how to map the input data from input message definitions to output 
message definitions, and when to write the transformed data to actual output messages. 

15 [0180] The user transforms input data in any way necessary to create the output messages the user needs. For 
example, the user may create a transformation expression that specifies concatenating a message item containing a 
customer's first name and a message item containing the customer's last name, because a target application requires 
the customer's full name in one data field. The user creates a transformation expression that specifies selecting only 
certain characters from a message item, or padding a message item with spaces to make it the right length for the cor- 

20 responding data field in the target application. The user then produces different output messages by writing them at dif- 
ferent points in the transformation process. 

[0181] When the primary input message does not contain all data needed to produce the output messages, the 
user can obtain supporting input for the transformation process using request/reply message definitions. For example, 
suppose the primary input message the user is using in the transformer definition uses abbreviations for United States 
25 state names (e.g., VA for Virginia). 

[0182] Assume, for example, that the target application requires full state names. To obtain the full state names 
needed to produce the output messages, the user would use a request/reply message definition that can send the 
abbreviations to an application and receive the state names in return. 

[0183] After the user has created a transformer definition 514, the user can test it to make sure it produces the 
30 proper output messages before using it in an integration flow. The user can then assign the transformer definition to one 
or more transformers 520. 

[0184] A transformer 520 implements a transformer definition 514. When the user creates a transformer 520, the 
user specify objects 510, 530 to use as sources of the primary input message and the objects 510, 530 that are to be 
targets for the output messages. The user also specifies the objects that are to reply to requests for supporting inputs. 

35 When the transformer 520 receives a primary input message from a source object 540, it runs the sequence of steps 
defined in the transformer definition 514 that make up the transformation process. It then reads the primary and sup- 
porting input messages, transforms the input data, writes the transformed data to one or more output messages, and 
sends the output messages to the target objects 540. A typical transformation process is shown in Fig. 9. The trans- 
former 520 receives a primary input message 920 from a hub 518. It then obtains a supporting input message 940 from 

40 a reply adapter 226. Finally, the transformer 520 sends two different output messages 960, 980 to two different target 
adapters 224. 

[0185] Hubs 518 are message holding areas for adapters 220 and transformers 520. Hubs 518 allow adapters 220 
and transformers 520 to exchange messages asynchronously, and simplify links among objects. For example, the user 
may have a source adapter 222 that produces messages to a transformer 520. The user may want the adapter 222 to 
45 produce and send its messages regardless of whether the transformer 520 is ready to receive them. The user could set 
up the adapter 222 to send its messages to a message hub 51 8, and set up the transformer 520 to receive the adapter's 
messages from that hub 518. The system 100 then delivers messages from the hub 518 to a target object 540 when 
the target is ready to receive them. 

[0186] Furthermore, the user may have three source adapters 222 sending messages based on the same mes- 
50 sage definition 512 to five targets 224, 520. If the user did not use a hub 518 (as shown in Fig. 10(a)), the user would 
have to create a total of 15 links among those objects. On the other hand, if the user uses a hub 518 as shown in Fig. 
10(b)), the user would have to create and maintain only eight links. Message hubs 518 can hold one kind of message 
only (i.e., messages produced from a single message definition 512). Targets of hubs 518 have durable subscriptions. 
The system 100 keeps track of the messages each target object 224, 520 has received from the hub 518, as well as 
55 those that the target objects 224, 520 have not vet received. If a target object 224, 520 becomes inactive, the system 
100 remembers the last message that the target object 224, 520 has received. When that target object 224, 520 next 
becomes active, the system 100 delivers only those messages that the target object 224, 520 had not yet received. If 
hub subscriptions were not otherwise durable, target objects 224, 520 would receive messages that arrived at hubs 518 
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while the target objects 224, 520 were active, but would never receives messages that arrived at the hubs 51 8 when the 
target objects 224. 520 were not active. 

[0187] The user can choose from two messaging styles the user wants the system 100 to use when delivering mes- 
sages from the hub 518: (1) point-to-point, where the system 100 delivers each message to the first available target 
only; or (2) publish/subscribe, where the system 100 delivers each message to every object the user has identified as 
a target of the hub 51 8. 

[0188] If the user wants to screen a certain kind of data out of pan of an integration flow 540, the user must use a 
filter definition 516. Filter definitions 516 specify criteria based on message data (i.e., data that passes the criteria con- 
tinues through the flow), while data that does not pass the criteria is discarded. 

[0189] When the user wants to filter a certain kind of message, the user creates a filter definition 51 6 and assigns 
it to one or more links between objects 540 that handle that kind of message. The system 1 00 applies the criteria in the 
filter definition 516 to all messages sent along those links. 

[0190] For example, consider the situation in which a hub 520 sends messages containing data on new customers 
to a target adapter 224. The user may want only data on customers who have not yet paid to reach the target adapter 
224. In order to do so, the user would create a filter definition 516, which specifies the criterion "Status = Paid" and 
assigns it to the link between the hub 51 8 and the target adapter 224. 

[0191] The user can create one or more filter definitions 516 for each message definition 512 in the user's integra- 
tion flow 540. The user can assign a single filter definition 516 to multiple links, or the user can assign different filter def- 
initions 516 for the same kind of message to different links. 

[0192] For example, consider the situation in which a hub 51 8 sends messages containing data on new customers 
to two adapters 220. The user may want one adapter 220 to receive only data on customers who have paid and the 
other adapter 220 to receive only data on customers who have not yet paid. The user would, thus, create two filter def- 
initions 516. One specifies the criterion "Status = Unpaid", and the other specifies the criterion "Status = Paid". The user 
then would assign each filter definition 516 to the appropriate link. 

[0193] When the user creates a filter definition 516 for messages that do not contain tables of data, the criteria the 
user specify affects the entire message. The entire message either passes the filter criteria and continues through the 
flow, or it does not pass and is discarded. 

[01 94] When the user creates a filter definition 51 6 for messages that contain tables of data, the user can specify 
criteria that affect the entire message or that affect only the data within a table. If the user specifies criteria for message 
items in a section 620, the entire message either passes the criteria and continues through the flow, or it does not pass 
and is discarded. If the user specifies criteria for message items in a table 640, the message continues through the flow 
with only those rows of data that pass the criteria. Rows that do not pass the criteria are discarded. 
[0195] For example, consider the situation in which a message contains a table 640 with nine rows of data, one for 
each of nine new customers. If the user set up a filter definition 516 that filters out customers who spent $1 000 or less 
rows containing data on customers who spent more than $1000 would continue through the flow, while rows containing 
data on customers who spent $1000 or less would be discarded. 

[0196] After the user has created a filter definition 516, the user can test it to make sure it works properly before 
using it in an integration flow 540. 

[0197] Once the system objects the user wants to use in an integration flow 540 exist, the user can indicate how 
the user wants the system 100 to route messages among them. To do so, the user sets up links among the integration 
objects 530. Each link establishes one object as a source and the other as a target, or one object as a requester and 
the other as a repl.er. Source adapters are always message sources. They can send messages to target adapters of 
the same agent service type (e.g., an SAP R/3 source adapter can send messages to an SAP R/3 target adapter) to 
message hubs 518, and to transformers 520. 

[0198] Transformers 520 can be targets, requestors, and sources. They can receive primary input messages 920 
from source adapters 222, message hubs 518, and other transformers 520. They also can request supporting input 
messages 940 from reply adapters 226 and message hubs 518, and send output messages 960, 980 to target adapters 
224, hubs 518, and other transformers 520. Message hubs 518 can be targets and sources. Target adapters 224 are 
always targets. They can receive messages from source adapters 222 of the same agent service type from hubs 518 
so and from transformers 520. 

[0199] By default, the system 100 uses "message persistence". That is, it writes each message it delivers from one 
integration object 530 to another to stable storage in a location the user specifies. If a system failure occurs while a mes- 
sage is in transit, the system 100 can retrieve the message from storage when the system is restored and deliver the 
message to its targets. 

55 [0200] Because message persistence increases system overhead, the system 100 allows the user to turn off per- 
sistence for any integration object 530. However, if a system failure occurs while messages to or from that object are in 
transit, those messages might be lost. The system 100 offers other delivery-related options that help the user manage 
the user's system resources. The system 100 maintains message holding areas for each integration object in an inte- 
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gration flow. The user can also control the size of these holding areas. 

[0201] The user can limit the number of messages the system 100 holds for each object at one time, and the user 
can limit the length of time the system 100 holds each message. If an integration object 530 produces messages more 
quickly than its targets can receive them, these limits can prevent the object's holding area from growing to a size that 

5 strains system resources. 

[0202] The user designs all integration flows within a project on the workbench 1 20. Those integration flows that the 
user designs and saves (i.e., the definition 510 and integration objects 530 that the user creates, and the links among 
them) are all stored in the repository 140. The project is a logical structure that lets the user view the repository 140. 
Each installation of the system 100 has one project and one repository 140. 

10 [0203] The general structure and design philosophy of the message object used by all message producers in the 
system 100 will now be disclosed. The message model as disclosed herein is infinitely extensible and useful for con- 
vening to and from native file formats as well as for sending interna! messages from node to node in the system 100. 
The message is hierarchical in nature and uses a name/value pair paradigm to represent the data. Data represented 
by the message model according to the present invention is always object based. It is an instance of a Java object of a 

15 certain class. Each data node is type-safe in the sense that it may only contain data that is of the specified class. The 
structure of a message is metadata-driven. 

[0204] That is, well-constructed messages are always built using the scheme laid out in an object known as the 
message definition 512. Every message of a certain "type" is built from the same message definition 512. The message 
definition 512 is itself an instance of a message, although its nodes have been extended to contain information on how 
20 to build instances of the format it describes, as well as optional information on how to convert data to and from a native 
application file format. 

[0205] As noted briefly herein above, a message 600 is a tree-structured collection of simple and compound 
objects. All objects that can appear in a message are various types of "message entries". In a presently preferred 
embodiment of the invention, a message entry comprises one of following types: (1) a data element: (2) an array ele- 
25 ment: (3) a table element: and (4) a section element or "message link". The message always has a single section ele- 
ment at the top of the tree, known as the "top level section". This and other sections may contain instances of any of the 
four element types. 

[0206] A data element contains "atomic" data, although the data is wrapped in a Java class. For example, integer 
data is stored in a java.lang. Integer object, data/time information is encapsulated in a java.util.Calendar object, and so 

30 forth. An array element is a collection of one or more primitive elements. An array's length is specified in the metadata, 
although this length may be specified as an allowable range, in which case the length is determined by parsing a native 
application's file record. A table element is actually an isomorphic collection of section elements, which means that 
each "row" of the table is a section containing exactly the same combination of names and types. It also has a poten- 
tially variable range specification. A message link is a pointer to another persistent message definition in the system 

35 and is used to merge formats. This is useful for implementing "redefines". The message can represent optional data, 
as well as default values, as dictated by the message definition. 

[0207] In its simplest usage, one creates an empty generic message is created by invoking a static factory method 
in the message definition class. This creates a message with all the proper name/value pairs, but each data item is set 
to null. The only publicly exported message constructor requires a message definition as a parameter, ensuring proper 
40 form. The message API provides a way to access its elements, either via named lookup or through section iterators. It 
should be noted at this juncture that the message supports a hierarchical naming scheme using a configurable separa- 
tor, allowing full or relative "pathname" access' to any component in the hierarchy. 

[0208] A section 620 is a non-repeating group of message elements. Such section elements do not themselves 
contain actual data. Instead, they contain other message elements that contain data (i.e., they contain items 660). Sec- 
45 tions 620 can contain any combination of message element types. 

[0209] A table 640 is a group of section elements, called rows that can repeat any number of times. Table elements 
also do not contain actual data. They contain other message elements that contain data (i.e., they contain items). 
Tables 640 can contain any combination of message element types. 

[0210] An item 660 is a message element that contains data. Items 660 are the lowest level message elements in 

so the hierarchy of the message definition. They cannot contain other message elements. 

[0211] The user designs all integration flows 540 within a project on the workbench 120. Those integration flows 
540 that the user designs and saves (i.e., the definition 610 and integration objects 620 that the user creates, and the 
links among them) are all stored in the repository140. The project is a logical structure that jets the user view the repos- 
itory 140. Each installation of the system 100 has one project and one repository 140. 

55 [0212] In accordance with another important aspect of the present invention, system 100 comprises a distributed 
system. That is, the user can run the system components that make up the system 100 on one or more physical 
machines (i.e., hosts), but all of the components working together as one application. 

[0213] A node is a physical process that runs on a host and supports one or more services. Each node is a Java 
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onl U nld e a fe h r«oh?\?K d , iS reC ° 9niZed by ° Perating SySt6m 35 3 iavawexe process - The user create at least 
one node for each host that runs an enterorisn anniiratinn tho , ,c», T .... 

as the user's business requirements dictate. ' " " '"" ** ma " y 00068 

5 conll ^n^ 8 ' 6 T P 7<Vn imerfaCeS Within ' he SyStem 100: (1) the ^bench 120: and (2) the administration 
5 console 160 The workbench 120 provides tools for creating and modifying integration flows 540, while the administra- 

nerer b S etow * man39in9 "" ^ n0dM a ° d ServiCeS ' B °' h are described in g-ate"etai, 

[021 5] Creating an integration flow 540 in accordance with the present invention may be done as follows The user 
» ZZlTV^TT' 5 ^ SVSlem 1 00 " °" the administ -tion console 160 the user then configures" e 

fTureT the renin °" ^ " aPpUCali0 " ^ USer wants ,0 "*■»»*• is ™™9- Then, the user con- 

figures the required serv.ces on the nodes, including an agent service for each application that the user is going to inte- 

[0216] In order to plan an integration flow, the user should determine the following factors. For example the user 
must determ.ne the kinds of data the user need to extract from applications and propagate to applicatls The use 
T^llTIT ° } ° W *? US6r W3n,S 10 r ° Ute meSSa9SS am ° n 9 the « ° b >e«* ( 2 ) user needs to 

SSdata^ttf SoT aPP " Cati0n 80 " ^ ^ ° ther aPP ' iCati0nS: «* (3) *• ™ «o filter 

[0217] On the workbench 120. the user should first create a project, and then create an integration flow in the fol- 
lowing manner. First the user should configure adapters 220 to interact with the user's applications and crele the mes- 
20 sage defines 512 the user needs to produce the proper messages in the integration flow 540. These message 
defin,t,ons 512 should then be tested to make sure they produce the proper messages 9 
[0218] Next, the user should create hubs 518 to hold messages from adapters 220 and transformers 518 The user 
may then create mapping definitions 514 to transform messages from the source application 541 to messaoes for the 

mauled r ati t ° n ^: Ur,h r ° re ' ^ Create Samp,e ^ meSSa ^ *2 P 0, an^se tlm o es h 
mapping defimfion 514 to make sure it produces the proper output messages 960 980 

i° 2191 „ /,u en, ! he US6r Sh ° U,d Crea,e ,he transformers 520 necessary to implement those mapping definitions 514 

outofte ^ow e 540 aP r ^ TTT 52 °' and 0UbS 626 Sh ° Uld be Nnked - lf the user " eeds ( o 'iter certa da 
out of the flow 540 the user should then create filter definitions 516. Preferably using sample messages the user 

£™v ?ho tne W ° rkbe r h 12 °' US6r Sh0U ' d then CheCk the VaNdit y of the in,eara «o n flow 540 and correct it as 
necessary The user may then save and close the project. On the administration console 1 60, the user should then con- 

S ie TZZZ T meSSa9GS ° n SyS,em ' f ,he USer Wants ,0 view statistics on system 

35 conjure fhe Z£ * ^ "° ' M * "» — ^ *« 

[pm nL« IS"' °" admin j stration cons ° le 160 - the ™er may start the integration flow by starting the relevant sys- 
tem nodes and servrces. mclud.ng the agent services for the applications the user is going to integrate Next the user 

£££ n 109 and ( S,ati f CS t0 make SUre the inte9ra,i0n fl0W 540 is runnin 9 P-Perly. If the user need ' to make 
STfS ySJSZ I ° W f^n US6r Sn ° U,d aCC ° rdin9,y S, ° P ,he re,eVant Services °" the administration con 
ro?221 Th^f T ,nte9 : at, °" fl0W 540 on the workben oh 1 20. and restart services on the administration console 1 60 
S wi » 2 ° W,n9 deSC : ibeS, ° one of ordinar V ski " in *e art the procedures that may be used with a source 
adapter wizard, a target adapter wizard, and a reply adapter wizard, all in accordance with the present invention to 
properly configure an adapter 220. In general, there are four separate processes 

[0223] First one must carry out the following general steps: (1 ) name the adapter 200; (2) choose the agent service 
to n nrod eS : r : S * ad , aPt6r c 20: <3) Ch °° Se ,he meSSa9e defini,i0n 512 for —ages that the adap S Tis 
£5 1?, S ^ r r reP ?/°' SeC ° nd ' mUS ' C3rry ° Ut the fo,,0Wina 9eneral s,eps: < 1 > c hoose a particular adapte 
220 that is to be configured (,e.. standard or custom); (2) provide connection information: and (3) provide imp.emeSta- 
-on information. More often than not, the step of providing implementation information includes he step of extrac ing 
the message definition 51 2 of that adapter 220. extracting 

50 in?!! , The I h ! r K P , r ° CeSS d8PendS ° n thS tyPe ° f adap,6r 220 10 be created - lf ° ne is crea «ng a source adapter 222 
creal I ^ ? TT^° ^ ^ 222 '* '° be US6d t0 Send messa 9 es - 0n th e other hand, if one is are 
creat ng a target adapter 224, one must specify the sources from which the adapter 224 is to be used to receive mes- 
sages If one .s creatmg a reply adapter 226, furthermore, one must specify the requesters (i.e. transformers 520) to 
which the adapter 226 is to be used to send reply messages. transformers 520) to 

S„ ° ne mU f f,naNy Specif V deliver y 0 P«ons (e.g., message lifetime) for the adapter's messages. However 

sotTeo Pn C I 6 f 3 '' 6 ' 22 °' ' he 39ent S6rViCe th3t iS '° h0St the adap,er ™st exist on the administration con^ 
sole 1 60. For example before one can create an EntireX Broker adapter, the agent service for the EntireX Broker must 
ex.st. If one wants to also specify source, target, or requester objects for an adapter 220 using the adapter wizard those 
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objects must exist before one opens the adapter wizard. 

[0226] Referring again to Figs. 4(a) and 4(b), agent-adapters 200 interface with the application resources on one 
side and the infrastructure of system 100 on the other. On the one hand, the adapter half of each agent-adapter 200 
uses the API of its particular application resource, or any other published interface mechanism. On the other hand, the 
5 agent side conforms to the event and messaging model of system 100 as described in greater detail herein below. In 
combination, the agent and adapter mediate the differences in interface protocols and data structures, providing a uni- 
form, normalized view of the business events that they publish and consume. 

[0227] Unlike other application integration solutions, the extensible design of the adapter architecture provides — 
the ability to seamlessly accommodate change to application interfaces, while still supporting the current set of basic 

10 interfaces. This is particularly important with systems that are already in production. For instance, a packaged applica- 
tion having a basic set of interfaces A' which are supported by a particular version of agent-adapter 200. If a newer ver- 
sion of the application incorporates a newer set of interfaces A", the user may choose to simultaneously adapt to the 
older interfaces A* for the production environment, while adapting to A" for a pre-production environment in order to test 
the new interfaces. With this facility, incremental change into the integration environment can be negotiated seamlessly. 

15 [0228] Every component of system 1 00 is distributable across ail supported platforms, agent-adapters 200 flexibly 
extend this to the participating applications. Key components of system 100 (e.g., agent-adapters 200 or integration 
server 26) can, thus, be co-located with applications, or accessed remotely, or both. Numerous deployment configura- 
tions are possible — the environment is optimized to balance availability, performance and administration requirements. 
[0229] Many standard adapters 200 are supplied with system 100, including SAP. MQSeries. ENTIRE Broker, 

20 RDBMS & CICS. As such, the adapters 200 support rapid deployment and easy integration of these information 
resources. They also reduce training and skills required. The ADK 130, including all of its automation wizards tem- 
plates, provides high productivity. It is adaptable to any user's IDEs, and it facilitates customizing supplied adapters and 
developing custom interfaces. The adapters 200 are made up of popular language and interface bindings, including 
C++, Java, EJB, CORBA, COM, and Natural. In such a manner, they plug into any user's environment and tools. They 

25 leverage in-house language expertise, and they are adaptable to complex resource interface requirements. The agent- 
adapter architecture according to the present invention, thus, provides a robust facility supporting far more than simplis- 
tic interfaces. It ensures a uniform event across the resource portfolio. 

[0230] The agent-adapter subsystem comprises the runtime interface modules that connect external applications 
to the EAI. On the adapter side, it is the physical interface to the external application. The agent side acts as a host for 

30 the adapter, manages resources and publishes events on behalf of the adapter. 

[0231] The base adapter classes within system 1 00 are as follows. The "Adapter Main" class provides the ability for 
the adapter to start itself and process its configuration definitions. It is also responsible for instantiating instances of the 
classes to be used by the four possible types of adapter communications. The "Adapter Receiver" class provides the 
ability for the adapter to receive a document from EAI and pass it on to the third party package. The "Adapter Sender" 

35 class provides the ability for the adapter to receive a document from a third party package and pass it on to EAI. The 
"Adapter Responded class provides the ability for the adapter to receive a document from EAI, pass it on to a third party 
package, receive a response from the third party package and return the response to the EAI for processing. The 
"Adapter Requestor" class provides the ability for the Adapter to receive a document from a third party package, pass 
it on to EAI for processing, receive a response from EAI and return the response to the third party package. 

40 [0232] The EAI agent-adapter interface according to the present invention is realized by the adapter implementing 
several Java interfaces, while the adapter to agent interface is realized by the adapter using known methods of the 
node/agent components. 

[0233] According to still another important aspect of the present invention, every adapter must implement the fol- 
lowing interface. For the AdapterBridge, the method: 

45 

initialize(Agent-adapterConfig) 

is invoked by the agent during initialization and used by the adapter to bootstrap itself. The adapter bridge is within the 
method that the adapter 220, 220', 220" must query the agent 210 to determine what document definitions are to be 
so processed and the type of processing provided for each document. This is accomplished using the following agent 
methods: 

GetsendDocumentDefinitionsQ 
getReceiveDocumentDefinitionsf) 
55 getRequestDocumentDefinitions() 
getResponseDocumentDefmitions() 

This method will then parse the AdapterConfiguration document to locate the subsection pertaining to the specific doc- 
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ument definition, harbor the document specific configuration information and create an instance of a specific class 

Dasea on processing type (send, receive, rennet nr rocnnnon^ It ...ill «..u 41.. _ -n. _ . .. . 

Request types), issue the AgenUetReceVve^ 

tener(,(Response type) to register the agent callbacks to be invoked when a message arrles A9ent Se,ReSp0nseLls - 
[0234] The restart ( ) method is invoked by the agent 220, 220\ 220" to cause the adapter 210 to terminate all activ 
SalT^ 

R^LJ^T^ 3150 imP ' emenled by « he a **' erS 220 as ^rein be.ow. For the 

onReceiveMessage(ReceiveData) 

aTa'rTr t n V ° ked ^ "J-! a9ent 21 ° ° n r6Ceipt ° f 3 JMS messa 9 e ' and he a 3 ent ™" the document on .0 the 
adapt* for processing. Th,s processing will occur under control of the JMS session thread The adapter processi d wj 
h h h consist of a one way routing of the document to the third party software application using the interfaces Dro- 

Tf c 6 a a^ap e C r a 220 ITT T "T' "f " "° ^ ^ ^ "» 3£a»tan^£ 
or can 1 ne adapter 220, 220 , 220 will be expecting only a success or failure response from the aoolication If EAI k 

onsendTimerEvent(SendData) 

MM fe invoted by ft. agent 210 if g» .dap.e, 220. a». 220" Is oBMng *, Bm „ „ a ,„ re „, „ e w , 

[0237] For the RequestListener interface, an 
onRequestTimerEvent(RequestData) 

3a method is invoked by the agent 210 if the adapter 220, 220\ 220" is utilizing the timer feature of the node/agent This 

frorthP ,^ Pr0C6SS ?- " Sh ° U,d be n0ted at this '^*> h ~> that the RequestUatenerTnSS^S 

™ ,?? : I 06 ' ,nterfaCe ' 10 th3t R WiH Send the d0CUment t0 EAI and -ait for a document in 2^ S 
response will then be passed back to the third party system. response. This 

35 [0238] For the ResponseListener interface, an 
onResponseMessage(ResponseData) 
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sS^^^TJl^T^ ° f 3 JMS meSSa9e ' * he **** 210 Wi » pass *• on to the 

aaapnr 220, 220 , 220 for process.ng. This process.ng will occur under control of the JMS session thread The adaoter 

b v the EE C ° nS '^k r ° Utin9 °' ^ d ° CUment 10 ,he third party software application using the TnteXcIs provided 
sJlm inn V 60 Sendin9 ' he reSP ° nSe b3Ck in '° ,he System 100 f °' add *°" a ' processing HoweveM the 
us'ed Lead ' " aC ' Ua ' r6SP0nSe ** * W * ReceiveL ^ner hLSSSS 

in Re' 1 12 T^ e n n nl USer inS,al '* SyStem 100 ' the mai " ~ m P°nent the user installs is a node manager 1210 as shown 
Ind se virL th T ° 13 3 ^ VirtUa ' maChine (JVM) ' which P rovides se ^ces to all of the other nodes 

n er£« Z ice 5? ' T" 1 SyS ' em inS,a " ati ° n aU '° ma,iCal,y Creat6S reposit0ry service 220 use 
02401 ' 3 m ° nit0r SerV ' Ce 1240 ° n the machine that hosts the nod * manager 1210. 

20I LJn ?h! US6r ?*" 3 3 C ' ient 1205 (e ' 9 " the adminis ' ra to" console 160 or the integration workbench 
20) seas on, the user must start the node manager 1210. As noted above, node manager 1210 automatical starts 

nr intlr Z k ,„ h0Se SemCeS are mnnin 9- pending on the particular administration console 160 

Z workbench 1 20 task the user is performing, other services may be required 

gen servi°es C 1250 'X%Tr™°* ^ C ° nfi9Ure ^ SyStem n ° deS and Services ' includin 9 

STiiJ^l the applications the user wants .0 integrate. The user initiates this by first using an administra- 

on ZTVn Se h SSIOn - Th c e user can then star ' a " integration workbench 120 session and begin designing^eg a- 

t ereaTe start then T7 , ^ Wh6n ^ " " d6Si9nin9 SUCh ^ 5 ^ * ' may 

thereafter start them by starfng nodes and services from an administration console 160 session. 
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[0242] When the user starts a client session, the user identifies the node manager 1210 as the client's server 1215. 
The user may connect as many integration workbench 120 and administration console 160 sessions to the node man- 
ager 1250 as the user's business requirements dictate. All such integration workbench 120 and administration console 
160 sessions will be read-only. Console sessions connected to the node manager 1250 have access to the contents of 
5 the repository service 520 that is running on that node manager 1210. When working with system 100, the user must 
run the node manager 1210, an administration console 160 session, and a integration workbench 120 session. 

Nodes 

w [0243] As noted herein above, and referring now also to Figs. 13(a) through 13(c) in conjunction with Fig. 12, a 
node 1310 is a physical process that runs on a host 1300 and supports one or more services. Each node 1310 is a Java 
virtual machine (JVM), and is recognized by the operating system as a javaw.exe process. The user must create at least 
one node 1310 for each host 1300 that runs an enterprise application that the user wants to integrate. The user can 
have as many nodes 1310 as the user's business requirements dictate. 

15 [0244] A service is an object that provides product functionality System 100 generally comprises system services 
and application services. A client graphical user interface (GUI), such as the integration workbench 120 and adminis- 
tration console 160, enables the user to work with system 100. Clients 1205 (Fig. 12) may run on the same physical 
host 1300 on which nodes 1310 and services are running, or it can run on a different host 1200. 
[0245] Each enterprise must also have a node manager 1210. The node manager 1210 provides services to all of 

20 the other nodes 1310 in the system 100. It runs the user interface service (UIS) 1230 and the repository service 1220. 
Fig. 13(a) illustrates one environment having three hosts 1300. Hostl is running the Node Manager 1210, while Hostl 
and Host2 are both running nodes 1310. 

[0246] System 100 is a collection of system services and application services. System services support nodes and 
services. For example, the monitor service 1240 stores system runtime data for nodes 1310 and services. Application 
25 services provide functionality to system 100. For example, CICS agent services support adapters that need to connect 
to CICS applications. 

System Services 

30 [0247] System services according to the present invention generally comprise a user interface service (UIS) 1230, 
a repository service 1220, and a monitor service 1240. UIS 1230 more specifically provides the facilities necessary to 
run client components (i.e., the integration workbench 120 and the administration console 160). Likewise, the reposi- 
tory service 1220 stores the configurations for all configured services and integration flow objects 540. Finally, monitor 
service 1240 stores system runtime data, including system logs and statistics information. 

35 

Application Services 

[0248] Referring again to Fig. 1 2, it can be seen that application services used in system 1 00 include the enterprise 
messaging service (EMS) 1260, which enables the system 100 to use multiple messaging modes, including point-to- 

40 point, publish/subscribe, and request/reply messaging. EMS 1 260 also supports message hubs and provides message 
persistence. Application services also include an integration service (IS) 1270, which enables the system 100 to trans- 
form messages, including splitting messages, combining messages, and manipulating message data. The IS 1270 
additionally supports transformers. RMI factory services (not shown) may optionally be used as an application service 
to manage remote method invocation (RMI) links to external applications. Routing services 1280 also comprise an 

45 application service, which enables the system 100 to direct messages through the system based on a message's con- 
tent, including filtering message content according to criteria the user define, and determining whether messages are 
valid. The routing service 1280 also supports filters. Agent services 1250 support adapters. The user must install an 
agent service on each host 600 that runs an enterprise application the user want to integrate. As shown in Fig. 13(b). 
Hostl and Host2 are both running services. Host3 cannot run services because is does not have a node 1310. 

50 

Clients 

[0249] The system 1 00 includes two client GUIs that enable the user to work with integration flows 540. Clients may 
run on any host 1300, regardless of whether the host 1300 runs the node manager 1210, runs nodes 1310 and serv- 
55 ices, or does not run any nodes 1310 or services. The user can install as many clients as the user's business require- 
ments dictate. For example, a user might want to install clients 1205 on a network-attached host to work with the user's 
integration flows 540 from a remote location. In Fig. 13(c), both Host2 and Host3 are running the administration console 
160 and integration workbench 120 clients. Hostl, on the other hand, is not running either the administration console 
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160 or integration workbench 120 clients. 

[0250] There are two orimarv intRrfappc within *k« «m,„»™ ,„wu. .. 

sole 160 The workbench l?n n™w«e"^ 7 ~' 0 "'" ' UU ' 1 u,b worKDencn ^ u ana Wie administration con- 

^^W^SS^^? T ° r Creat,n9 and m ° difylng inte 9 ratlon flows 700 > ^ the administration 

5 S^bJS^ 00,5 mana9in9 SySt6m n ° deS and Services - Both « ascribed in greater oS 

Sust o£T2 ^ inte9rati ° f n ^ 700 ^ acCOrdance with the P«*ent invention may be done as follows The user 
SLerl7melt n ordl??hT i0n ^ T ^ * Me ^ fac,ors - F ° r — *■ user 

^wir^r^ d s ^z^^ST 1 app,ica,i r and propa9ate to app,ica,ions The user 

The Conversion Prnr»QQ — Accessors anH nnnw^ 
shou.dn't happen too often ' nd ' V,dUa ' aCC6SS ° rS may ° Verride an * of these ' but j " P**» ■* 

mmmm 
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Mccessor type 


i^naracierisuc 


5 


nxeu lenyui 


Mccessor iieiu is always a nxeu lenyin. i ms iixea lenyin indicates eimer ine enure iieiu 
length, or its length minus any markers. 


10 




cssenuaiiy ine same as a nxeu lenyin accessor, except inai anomer inieger-compaiiDie iieiu 
in the data contains the length specifier. These length indicators are what are known as 
linked" objects, and may optionally be flagged as "transient" objects, the details of both of 
which are described in greater detail herein below. 




Trailing marker 


The field terminates at the trailing marker. 




Implied length 


The field length is implicit in the converter type - mostly used for binary formats. 


15 


Section-delimited 


If the containing section uses a delimiter scheme, the delimiter can signal the end of the 
object. 




Syntax-based object 


The object matches a certain regular expression. 



20 

[0259] It should be noted that each of the accessors described above are item accessors. While much simpler, sec- 
tion accessors may likewise be used. Such section accessors have optional markers, and may also use a delimiter 
scheme. To some extent, the inclusion of such a delimiter scheme depends on the successful parsing of its contained 
elements. Delimiters use either a prefix, infix or posifix scheme, and are in fact the same marker elements used to con- 

25 strain fields. Table accessors extend section accessors to work with a linked item that indicates a record count. 

[0260] The initial number of converters supporting the system 100 is relatively small, but is very complete based on 
an analysis of commercial file formats. The converters according to the present invention comprise two basic types: 
either a character-based convener or a binary converter. All character converters inherit from a common base class that 
provides the notion of justification and padding characters. Such padding characters may be specified as absolute byte 

30 value characters or as Unicode characters, which are mapped to the native encoding. Character converters according 
to the present invention include: 



35 


Character Converter 
Type 


Characteristic 


40 


Decimal 


Formats and parses according to a "format mask", derived from that specified in 
java.text.DecimalFormat. The mask is of the form #,##0.0##, and can specifly features 
such as leading or trailing minus signs, etc. The mask grammar will be extended as 
needed to enable any pre- or post-processing where the grammar is insufficient. 




Integer 


Same as decimal converter, but no decimal places are allowed. 




Currency 


Also supported by Java, a further refinement of decimal converter. 


45 


Date/time 


Uses java. text. SimpleDateFormat mask specification. Thisformat is quite extensive, and 
should satisfy all needs. 




Generic string 


Relies on fixed length, trailing marker or section delimiter for demarcation. 



50 [0261] Binary converters inherit the default message-specified byte-order, but may be individually overridden via a 
constructor argument. Those binary converters according to the present invention include: 
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w 



15 



Binary Converter Type 



Signed/unsigned 2's 



IEEE 754 float and double (1985 specification) 



Packed decimal 



Characteristics 



Complement numbers of 8, 16, 32 and 64 bits as well. Unsigned 
types are promoted to the next larger Java integral type if needed 
It should be noted that Java includes an arbitrary precision pack- 
age in java.math for unsigned longs. 

JNI can be used for this, as well as IntegerBits and LongBits con- 
verters provided in the Float and Double classes. It should be 
noted that this may only be supported on platforms of a native 
float type. 
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interface, which specifies a roTec Sc'lass rU? T," 9 ST* A " ^ implemen « a native «™erter 
class produced depends on whS other inverter intend ' T* - fUnCti ° nalil * H « *• -dual sub- 
marker interfaces, which do not ^ te to any l^T' T by These are essentia "y 
StringConverter. and so forth maXus2l n 2 sZTE? » °7* amp,e - a DoubleConverte, IntegerConverter, 
present invention. A configuring such s i , fT deParUn9 fr ° m the ,me Spirit and SC0 P* «f the 
mine an appropriate list o ^verterc o ™ ^n/Lf* "** ' n,erfaCe (GU,) Can> thr0U9h class introspection, deter- 

verter examines whic of ££££ K^ZES?'' ^'J^ ^ St0re meth ° dS - the COn " 

°-es UPP ,iedaas^^ 

Markers 

S. whS^rns^ T f « eId de '^ a " d incividua, item tokens. A„ 

ently preferred ^nbod^oT^ZiS?^ are liTSS ^ r™^' " b °' h - aCC ° rdanCe Wi,h a pres - 
tern marker and a "strtok"-style maZ soecS *Z » Z « ° rmatS - Tw ° f ° rmatS ' known as a fi * ed P a <" 

character encoding. Comprises of cha L^wh^OofZ " " ^ ^ * maPPed t0 native 
is useful for indicating white space or ^nadlo Th J thin r ? ° CCU ™ Ces are found - the»strtok"-style marker 
key of an object being processed \"s2m^2 ^ T ^ markerS ' nave a P attern in w hich the 

become (Customers ?i^^I^^ , ^? Mim V?r eXamP ' e ' *" ^ Pair < X "> and (/ - X -> would 
aid in locating optional items * ^ f0r ParSi " 9 XML - Sl * e messa 9 es - ™<* 

in general help 

40 Optional Arqnmont ? 

iK^eo^r^ 

string is which. Optional Ls no" 3w be seUc Sn the messa^ A Ti " T ^ * P ° SSib ' e '° kn0W Which 
may be recogni2ed jn acCQrdance ^ ^ ^Z^oZT^ ** °' C ° nd ' ti0nS ^ WW * ^ ile ™ 

come at the end of the .ist am he tZnlZ^^T' ™" " 9 " ° f ' he 0p,ional ar 9 ument * 

parse a field correctly, and h eMU oZna, teZtt' , '* SUCCeSSfU '' general ' whenever a user fai '* to 
is reached. A section with V^S^J^Z 5* '° 'A^' field a " d W " again until ,he end «* *• section 
optional items have no, been JZ!^£^^*JZ!% ^ f ^ ° f lhe if — 

successive items would be ambiguous guarantee correct results if the format of 

message instance. If it do s ^ ^Z^t lT^^ ? * M ^ ,hS metadata ,0 the 
class and the Java Reflection API i -used , invoke I J ""^ 38 8 S,r ' n9 in the metadata ' alon 9 with its 

S US6d '° ' nVOke the 0D J ects Stnng-based constructor to supply the message with 
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an object. For sections, the default is a link to another persistently-stored message definition. The top-level section of 
the referenced message definition would be grafted into the message metadata and a message of the combined struc- 
ture would bes produced. 

5 Linked and Transient Items 

[0267] In some cases, native data is self-describing. For example, a table may be preceded by its row count. Users 
would not want to include this count in the final canonical message produced, however, because it is self-evident from 
the length of the Java array representing the table. In this case, the node may optionally be marked as transient. It is 
10 temporarily added to the message and removed once the table has been built and added. In this way, the user may con- 
figure a message definition with two different drivers to produce the same canonical message. That is, if in one case, 
the table length were determined without a count indicator, it would not produce that integer field in the node. Tables 
should be isomorphic in this case, so the argument should be transient. 

[0268] Continuing on with the above example, one may note that there is an inherent connection between the count 
15 and the table. As a result, both will be marked as having a link relationship. Both will additionally hold onto the relative 
and absolute pathname of the other object, plus a status indicator in their accessors as seen below. 

COUNT-PROVIDER 
COUNT-USER 
20 LENGTH-PROVIDER 
LENGTH-USER 
REDEFINE-PROVIDER 
REDEFINE-USER 

25 In the case of redefines, the provider either provides a string or integral discriminant. The provider item must appear, in 
the parsing direction, before its user in the traversal and conversion. In the formatting direction, the provider is first writ- 
ten with a placeholder and subsequently filled in with its proper value. It should be noted that the count provider must 
use a fixed length format for the above to work. 

30 Validation Clauses and Relationships 

[0269] The message definition has placeholders in its metadata items for a list of validation clauses and inter-mes- 
sage relations. In accordance with a presently preferred embodiment of the invention, validation clauses are all run on 
the converted message only after the entire message has been converted. The object design does, however, permit 
35 per-item validation clauses if desired. There is also a placeholder to specify relations between columns of a table in one 
message and columns in another one. This facilitates mapping of values and joins. 

[0270] The manner is which message may be created, without and with converting the raw data, is shown in Figs. 
13 and 14. Fig. 13 illustrates one method 1340 without converting the raw data that begins at the application 541. 
[0271] The user creates an empty message (e.g., "Doc Def.createNew Instance") at 1320, and the empty message 
40 is populated with the application's data through the message definition API 1330. A message instance 1340 is, thus, 
created. The message instance 1340 then can then go through another application's message definition API 1350 in 
order to send the message to that application 1360. 

[0272] When the need to convert the raw data arises, the method shown in Fig. 1 4 is employed- In the beginning 
application specific data 1410 is received from an application 1420. An empty message is created at 1430 and popu- 
45 lated with not only such application specific data 1410, but also raw conversion information. The application specific 
data 1410, by way of the accessors and converters 1440 is sent to a message instance 1450, which also receives the 
information populated in the empty document at 1430. For example, this may be done by: 

DocDef.createDocumentFromFile 

50 

The API supports both of the following methods to create the message: 

DocDef.createDocumentFromFile 
DocDef.createDocumentFromBytes 

55 

Then, through other accessors and converters 1460, the message can be converted into another application's applica- 
tion specific data 1470 and received by that application 1480. 

[0273] Referring now to Figs. 15(a) through 15(d), the benefits of the message object according to the present 
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5 coupled ,o the messagTd^^ The a "" icati °" API 1514 is 

1516. The, message defaut tay^e t be apolied ?I ° T, , n meSSa9e °' ™ SSage deW,on API 
sage instance 1518 is thus cmid Th7 r ! ( t ^^ ^P'y^^^'D^ultValuesfdocnamer), and a mes- 

nition AP1 1536 creates an IJ^SUTSS^ T ^ 1532 ' hr ° U9h 3 « The messa 9 e defi " 
either from a file or from £2 and adds ™ Sin meSS39e ^ ^ ^ ,he appHcali0n 1532 

present invention. For example ^ ' nf0rmatl0n fr0m acCessors and c °^erters according to the 
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Document Definition def;//Add Accessors and Converters 
Initialize elsewhere 

def.createDocumentFromFile(c/ocname ( ///eA7aAne) 



or, 



defxreateDocumentFromBytesfcfocname^yte//) 

1« - sent through the message dedi- 
cation 1 548. For example: * ^ *** ^ thG meSSage inStance 1532 ' and then to the appli- 



cation 1548. For example: 

Document Definition d 
Initialize elsewhere 
def.storeDocumentToFile(/7/ename) 



Document Definition def;//Add Accessors and Converters 
30 Initialize elsewhere 



or, 

35 def.storeDocumentToBytes(6yte/7) 
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Class diagrams for similar such processes are shown in Figs. 16 and 17 

IS. ThTt tx a z w z tz '7:T c :r ci °: th : present invention - system 100 com ^ * 

machines (/.a, hos^ make ^ the « 100 on one or more physical 

is distributable acrosl ^ZZaZT^ ? onnn ^ EVery C ° mp0nent of s ^ 1 00 

Key components of sys em 2 °° "^'"^ 6Xtend thiS t0 the WpaUng applications. 

Operators 



Operator 


Description 


&& 
II 


Logical "and" 
Logical "or" 
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(continued) 



Operator 


Description 


! 


Logical "not" 


- 


Assignment 


= = 


Logical "equal" 


!= 


Logical "not equal" 


+ 


Unary plus 


- 


Unary minus 


* 


Multiplication 


/ 


Division 


< 


Less than 


<= 


Less than or equal to 


> 


Greater than 


>= 


Greater than or equal to 



Functions 

[0278] The table following on the next page generally describes all of the currently contemplated system functions, 
25 which a user can use to build expressions for validating or filtering messages and transforming message data. Each 
description includes what the function does, the parameters it requires, and the value it returns. 
[0279] When transforming message data, the user typically uses these functions to take message item values from 
input messages and create message item values for output messages. When validating or filtering messages, the user 
usually uses these functions to create boolean expressions. The parameter values for these functions can either be 
30 message items or constant (i.e., literal) values. 



Data Type 


Literal Examples 


Integer 


1234, OxFF, 077, -1234 


Long 


1234, 1234L, -OxFF, 077L 


Double 


12.34 


String 


"Sagavista" 


Boolean 


true or false 


BigDecimal 


12.34a, where "a" means arbitrary precision 


Calendar 


#DATE{2000, 2, 13) 




#DATE_TIME(2000, 2, 13, 23, 59) 




#DATE_FORMAT("M/d/yyyy", "2/1 3/2000") 



50 [0280] The system 100 also provides the functions described below, although a user can write the user's own func- 
tions for use with system 100. 
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F unction 
addToDate 

bigDecimalTo Boolean 

bigDecimalToDouble 

bigDecimalToLong 

bigDecimalToString 

booleanToBigDecimal 

booIeanToLong 

booleanToString 

calendarToString 

compareDates 

doubleToBigDecimaJ 
doubJeToLong 



Description 



Adds a specified number of days to a Calendar object date 
and returns the resulting Calendar object date 

Converts a BigDecima] object to a Boolean object 

Converts a BigDecimal object to a Double object 

Converts a BigDecimal object to a Long object 

Converts a BigDecimal object to a String object 

Converts a Boolean object to a BigDecimal object 

Converts a Boolean object to a Long object 

Converts a Boolean object to a String object 

Converts a Calendar object to a String object 

Compares two Calendar object date values and indicates 
whether the first date is less than, equal to, or greater than 
the second date 

Converts a Double object to a BigDecimal object 
Converts a Double object to a Long object 



doubieToSirino 
findString 



Converts a Double objeci 10 a Siring object 

Searches for a String objeci within another String object 
and returns the position of the found String's first character 
within the other String 
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Function 



Description 



find Word 

foundString 

foundWord 

getDate 

getMonlh 

getYear 

getTokenAt 

integerToString 
isAlpha 

isAIphaNumeric 

isNumeric 

justifyCenter 

justify Left 

justifyRight 

longToBigDecimal 

longToBoolean 

longToDouble 

longToString 

lookup 



Searches for a word within a String object and returns the 
position of the word's first character within the String 

Searches for a String object within another String object 
and returns a Boolean object 

Searches for a word within a String object and returns a 
Boolean object 

Finds the date in a Calendar object and returns the month as 
an Integer object 

Finds the month in a Calendar object and returns the month 
as an Integer object 

Finds the yeai in a Calendar object and returns the year as 
an Integer object 

Parses a String object into tokens, finds a particular token, 
and returns the token as a String object 

Converts an Integer object to a String object 

Determines whether all characters in a String object are 
alphabetic and returns a Boolean object 

Determines whether all characters in a String object are 
alphanumeric and returns a Boolean object 

Determines whether all characters in a String object are 
numeric and returns a Boolean object 

Creates a String object of a specified length and centers 
another String object within it 

Creates a String object of a specified length and left 
justifies another String object within it 

Creates a String object of a specified length and right 
justifies another String object within it 

Converts a Long object to a BigDecimal object 

Converts a Long object to a Boolean object 

Converts a Long object to a Double object 

Converts a Long object to a String object 

Looks up a String object in a lookup table specified in 
another String object and returns the corresponding value 



lowercase 



Converts all characters in a String object to lowercase 
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Function 



10 



15 



20 



25 



30 



35 



replaceString 



rep] ace Word 
sizeOf 

stringToBigDecimal 

stringToBoolean 

stringToCalendar 

stringToDouble 

stringTolnteger 

stringToLong 

Subarray 

substring 

trim 

uppercase 



uescripiion 

Searches a String object for a particular String object, 
replaces the found String object with a replacement String 
object, and returns the String object with the replacement 
String in place 

Searches a String object for a particular word, replaces the 
found word with a replacement word, and returns the String 
object with the replacement word in place 

Determines the size of a String object or a ByteArray object 
and returns the size as a Long object 

Converts a String object to a BigDecimal object 

Converts a String object to a Boolean object 

Converts a String object to a Calendar object 

Converts a String object to a Double object 

Converts a String object to an Integer object 

Converts a String object to a Long object 

Finds a ByteArray object within another ByteArray object 
and returns the found ByteArray object 

Finds a String object within another String object and 
returns the found String object 

Removes white space from before and after a String 

Converts all characters in a String object to uppercase 



40 

addToDate 



JeTnl that SP6CifieS 3 C6rtain nUmb6r ° f ^ 10 3 Ca ' endar date - 

45 

Calendar addToDate(Calendar,Long) 
[0282] 



50 



Parameter Type 


Value 


(Calendaring) 


Date, number of days to add to the date"" 


Return Type 


Value 


Calendar 


Resulting date 
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Example: 

[0283] A message item named DatePurchased is defined as a Calendar object. For another message, the user 
need the value of DatePurchased plus five days in a Calendar object. The user would enter the function as follows: 

5 

addToDate (MsgDef.DatePurchased, 5) 

If the value of DatePurchased were equivalent to February 1 3, 2000, the function would return a Calendar object whose 
value is equivalent to February 18, 2000. 

10 

bigDecimalTo Boolean 

[0284] This function converts a BigDecimal object to a Boolean object. 
15 Boolean bigDecimalToBoolean(BigDecimat) 
[0285] 

20 



Parameter Type 


Value 


(BigDecimal) 


BigDecimal to convert 


Return Type 


Value 


When 


Boolean 


True 


BigDecimal is any value other than 0 




False 


BigDecimal is 0 



30 bigDecimalToDouble 

[0286] This function converts a BigDecimal object to a Double object. 
Double bigDecimalToDouble(BigDecimal) 

35 

[0287] 



Parameter Type 


Value 


(BigDecimal) 


BigDecimal to convert 


Return Type 


Value 


Double 


Resulting Double 



bigDecimalToLonq 

[0288] This function converts a BigDecimal object to a Long object. 

50 
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Long bigDecimaiToLong(BigDecimal) 
[0289] 

5 



Parameter Type 


Value 


(BigDecimal) 


BigDecimal to convert 


Return Type 


Value 


Long 


Resulting Long 



biaDecimalTnStrinri 

15 

[0290] This function converts a BigDecimal object to a String object. 
String bigDecimalToString(BigDecimal) 
20 [0291] 



Parameter Type 


Value 


(BigDecimal) 


BigDecimal to convert 


Return Type 


Value 


String 


Resulting String 



booleanToBiaDecimal 

[0292] This function converts a Boolean object to a BigDecimal object. 

BigDecimal booleanToBigDecimal(Boolean) 

[0293] 



Parameter Type 


Value 


(Boolean) 


Boolean to convert 


Return Type 


Value 


When 


BigDecimal 


1 


Boolean is true 




0 


Boolean is false 



50 booleanToLong 

[0294] This function converts a Boolean object to a Long object. 
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Long booleanToLong(BooIean) 
[0295] 

5 



Parameter Type 


Value 


(Boolean) 


Boolean to convert 


Return Type 


Value 


When 


Long 


1L 


Boolean is true 




0L 


Boolean is false 



15 

booleanToStrinq 

[0296] This function converts a Boolean object to a String object. 
20 String booleanToString(Booiean) 
[0297] 

25 



Parameter Type 


Value 


(Boolean) 


Boolean to convert 


Return Type 


Value 


String 


Resulting String 



calendarToString 

35 [0298] There are two versions of this function. 

[0299] The following function converts a Calendar object to a String object. 

String calendarToString(Calendar) 

40 [0300] 



Parameter Type 


Value 


(Calendar) 


Calendar to convert 


Return Type 


Value 


String 


Resulting String 



50 

[0301] The following function converts a Calendar object to a String object, using a format mask to format the String 
object. 

55 
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String calendarToString(Calendar,String) 
[0302] 

5 



10 



15 



20 



Parameter Type 


Value 


(Calendar.String) 


Calendar to convert, format mask 


Return Type 


Value 


String 


Resulting String, in the format specified by the mask 



Example: 

[0303] A message item named DatePurchased is defined as a Calendar object. For another message, the user 
need the value of DatePurchased in a String object, in the format M/d/yyyy. The user would enter the function as follows: 

calendarToString (MsgDef.DatePurchased, "M/d/yyyy") 
value j5i^^ PUICh ^ W6re equiV3,ent t0 February 13 " 2000 ' the function wou,d return a String object whose 



compareDates 

25 

[0304] This function compares two Calendar object 
equal to, or greater than the second date. 



values and indicates whether the first date is less than, 



Long compareDates(Calendar,Calendar) 

30 

[0305] 



Parameter Type 


Value 


(Calendar.Calendar) 


First date to compare, second date to compare 


Return Type 


Value 


When 


Long 


-1 
0 

1 


First date is less than second date 
First date is equal to second date 
First date is greater than second date 



45 doubieToBigDecimal 

[0306] This function converts a Double object to a BigDecimal object. 



55 
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BigDecimal doubleToBigDecimal(Double) 
[0307] 



Parameter Type 


Value 


(Double) 


Double to convert 


Return Type 


Value 


BigDecimal 


Resulting BigDecimal 



tfoubleTQLong 

15 

[0308] This function converts a Double object to a Long object. 
Long doubleToLong(Double) 
20 [0309] 



25 



Parameter Type 


Value 


(Double) 


Double to convert 


Return Type 


Value 


Long 


Resulting Long 



30 

doubleToStrinq 

[0310] There are two versions of this function. 

[0311] The following function converts a Double object to a String object. 

35 

String doubleToString(Double) 
[0312] 

40 



Parameter Type 


Value 


(Double) 


Double to convert 


Return Type 


Value 


String 


Resulting String 



[0313] The following function converts a Double object to a String object, using a format mask to format the String 
so object. 



55 
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String doubleToString(Double.String) 
[0314] 



10 



15 



Parameter Type 


Value 


(Double.String) 


Double to convert, format mask 


Return Type 


Value 


String 


Resulting String, in the format specified by the mask 



Example: 



20 



[0315] A message item named Discount is defined as a Double object. For another message the user need th* 
value of D,scount in a String object, in the format ft*. The user would inter the function ^follows: 

doubleToString (MsgDef.Discount, "#.##") 

If the value of Discount were 0.04531 , the function would return a String object whose value is "0.05". 
findString 

25 StnnnLi Jt h ? fU f ncti0, ; K Searches for a Strin 9 object within another String object. If the function finds the specified 
String object, it returns the pos.tion of the String's first character within the other String. 

Long findString(String,String) 

30 [0317] 



35 



40 



Parameter Type 


Value " " " ■ — 


(String, String) 


String to search, String to find 


Return Type 


Value 


When 


Long 


Position of the String's first character within the other String 
-1 


String is found 
String is not found 



find Word 

45 [031 8] This function searches for a word 
position of the word's fir 
space within the String. 



nnc-ti ,n.fn . r Within a Strlng object lf the function finds the specified word it returns the 

firSt Ch3raC,er W " hin the Slrin 9 The «n only find the word when it is bounded bj while 



50 



55 
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t ■ 

Long findWord(String, String) 
[0319] 



Parameter Type 


Value 


(String, String) 


String to search, word to find 


Return Type 


Value 


When 


Long 


Position of the Word's first character within the String 
-1 


Word is found 
Word is not found 



15 

foundStrino 

[0320] This function searches for a String object within another String object and returns a Boolean object. 
20 Boolean foundString(String,String) 
[0321] 



Parameter Type 


Value 


(String, String) 


String to search, String to find 


Return Type 


Value 


When 


Boolean 


True 


String is found 




False 


String is not found 



35 found Word 

[0322] This function searches for a word within a String object and returns a Boolean object. The function can only 
find the word if it is bounded by white space within the String. 

40 Boolean found Word(String, String) 

[0323] 



Parameter Type 


Value 


(String.String) 


String to search, word to find 


Return Type 


Value 


When 


Boolean 


True 


Word is found 




False 


Word is not found 



55 getDate 

[0324] This function finds the date in a Calendar object and returns the date as an Integer object. 
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Integer getDate(Calendar) 
[0325] 



10 



15 



Parameter Type 


Value 


(Calendar) 


Calendar to read 


Return Type 


Value 


Integer 


Resulting Integer, from 1 through 31 



Example: 



!?pH 6 L „i ? SSa t f ite , m n ?rf d Da,ePurchased is defin <* as a Calendar object. For another message, the user 
need the date from the value of DatePurchased in an Integer object. The user would enter the function as follows: 

GetDate (MsgDef.DatePurchased) 
ITuels 'Ja ° f Da ' ePUrChaSed W6re equiva,ent t0 Februar V 1 3 ' 2000 ' ^ ^tion would return an Integer object whose 
qetMonth 

[0327] This function finds the month in a Calendar object and returns the month as an Integer object. 
Integer getMonth(Calendar) 
30 [0328] 



20 



25 



35 



40 



45 



50 



Parameter Type 


Value 


(Calendar) 


Calendar to read 


Return Type 


Value 


Integer 


Resulting Integer, from 1 through 1 2 



Example: 

Sh* m lr f SSag r temnarn ( e n DatePurchased is defined as a Calendar object. For another message, the user 
need the month from the value of DatePurchased in an Integer object. The user would enter the function as follows: 

getMonth (MsgDef.DatePurchased) 
vaJuelsT ° f ° a,ePurChaSed Were equivalent t0 Februar V «. 200 °. *e function would return an .nteger object whose 
qetTokenAt 

[0330] There are two versions of this function. 

55 En nh- I^"?*? fUn ° ti0n PafSeS 3 ^ ° bj6Ct M ° t0kenS ' finds a particular token ' and ret "™ the token as a 
to return aSSUmeS ' hal * ™* ^ the US6r indica,e the P° sitjon of ,he ^ 

Sialue^ StrinS 10 PafSe C ° mainS 3 Va ' Ue ° f SPedfied ,0k6n P ° Si,i0n iS ° ut of range ' ,he function returns 
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String getTokenAt(StringJnteger) 
[0333] 



Parameter Type 


Value 


(String, Integer) 


String to parse, position of the token to find (starting with 0) 


Return Type 


Value 


String 


Indicated token, or a null value 



[0334] The following function parses a String object into token, finds a particular token, and returns the token as a 
15 String object. The function lets the user specify the character that delimits the tokens and lets the user indicate the posi- 
tion of the token to find. 

[0335] If the String to parse contains a null value or the specified token position is out of range, the function returns 
a null value. 

20 String getTokenAt(String,String,lnteger) 
[0336] 



25 



Parameter Type 


Value 


(String.String. Integer) 


String to parse, delimiter, position of the token to find (starting with 0) 


Return Type 


Value 


String 


Indicated token, or a null value 



Examples: 
35 [0337] 

(1 ) A message item named Date is defined as a String object that contains a date in the format M/d/yy. For another 
message, the user need the month from the value of Date in a String object. The user would enter the function as 
follows: 

40 

getTokenAt (MsgDef.Date, T, 0) 
If Date contained "2/13/00", the function would return a String object whose value is "2". 

(2) A message item named Date is defined as a String object that contains a date in the format MM.dd.yy. For 
45 another message, the user need the date from the value of Date in a String object. The user would enter the func- 
tion as follows: 

getTokenAt (MsgDef.Date, V, 1) 

so If Date contained "02.13.00", the function would return a String object whose value is "13". 

(3) A message item named Date is defined as a String object that contains a date in the format M/d/yyyy. For 
another message, the user need the year from the value of Date in a String object. The user would enter the func- 
tion as follows: 

55 getTokenAtMonth (MsgDef.Date, 7", 2) 

If Date contained "2/13/2000", the function would return a String object whose value is "2000". 
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aetYear 

[0338] This function finds the year in a Calendar object and returns the year as an Integer object. 
5 Integer getYear(Calendar) 
[0339] 



10 



15 



Parameter Type 


Value 


(Calendar) 


Calendar to read 


Return Type 


Value 


Integer 


Resulting Integer 



Example: 

20 [0340] A message item named DatePurchased is defined as a Calendar object. For another message, the user 
need the year from the value of DatePurchased in an Integer object. The user would enter the function as follows: 

getYear (MsgDef. DatePurchased) 
25 value is 2000 DatePUfChaSed W6re e < uiva,ent to Feb ™ry 13, 2000, the function would return an Integer object whose 
inteqerToString 

30 [0341] There are two versions of this function. 

[0342] The following function converts an Integer object to a String object. 

String integerToString(lnteger) 

35 [0343] 



40 



45 



Parameter Type 


Value 


(Integer) 


Integer to convert 


Return Type 


Value 


String 


Resulting String 



oS f0,l ° Win9 fUnCtl ° n COnVGrtS ^ ,nteQer ° bjeCt t0 3 Stdn9 ° bjeCt ' USinQ 3 format mask t0 format the Strin 9 



50 



55 
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String tntegerToString(lnteger,String) 
[0345] 

5 



Parameter Type 


Value 


(Integer.String) 


Integer to convert, format mask 


Return Type 


Value 


Sting 


Resulting String, in the format specified by the mask 



Example: 

15 

[0346] A message item named Quantity is defined as an Integer object. For another message, the user need the 
value of Quantity in a Sting object, in the format #,###. The user would enter the function as follows: 

IntegerToString (MsgDef.Quantity, "#,###") 

20 

If the value of Quantity were 2540, the function would return a Sting object whose value is "2,540". 
isAlpha 

25 [0347] This function determines whether all characters in a Sting object are alphabetic and returns a Boolean 
object. 

Boolean isAlpha(String) 
30 [0348] 



Parameter Type 


Value 


(String) 


String to check 


Return Type 


Value 


When 


Boolean 


True 
False 


All characters are alphabetic 
Not all character are alphabetic 



isAlphaNumeric 

45 [0349] This function determines whether all characters in a String object are alphanumeric and returns a Boolean 
object. 

50 
55 



41 



Boolean isAlphaNumeric(String) 
[0350] 
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w 



15 



isNumeric 



Parameter Type 


Value 


(String) 


String to check 


Return Type 


Value 


When 


Boolean 


True 
False 


All characters are alphanumeric 
Not all character are alphanumeric 



[0351] This function determines whether all characters in a String object 
20 Boolean isNumeric(String) 
[0352] 



are numeric and returns a Boolean object. 



25 



30 



35 iustifvCenter 



Parameter Type 


Value 


(String) 


String to cheek 


Return Type 


Value 


When 


Boolean 


True 
False 


All characters are numeric 
Not all character are numeric 



[0353] There are two versions of this function 

[0355] If the centered String is longer than the specified length, the function returns a null value. 
String justifyCenter(String,lnteger) 
45 [0356] 



50 



55 



Parameter Type 


Value 


(String, Integer) 


String to center, length of the String to return 


Return Type 


Value 


String 


Resulting String, or a null value 



42 
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[0358] If the centered String is longer than the specified length, the function returns a null value. 
String justifyCenter(String,lnteger,String) 
5 [0359] 



Parameter Type 


Value 


(String, Integer.String) 


String to center, length of the String to return, and character to use to pad the String 


Return Type 


Value 


String 


Resulting String, or a null value 



15 

Example: 

[0360] A message item named Name is defined as a String object. For another message, the user need the value 
of Name, centered in a String object of length 20, and padded if necessary with asterisks (*). The user would enter the 
20 function as follows: 

JustifyCenter (Msg Def. Name, 20, M# ") 

If the value of Name were "Wolfgang A. Mozart", the function would return a String object whose value is "'Wolfgang 
25 A. Mozart*". 

justifyUeft 

[0361] There are two versions of this function. 
30 [0362] The following function creates a String object of the length indicated by an integer object and left justifies a 
String object within it. If the left-justified String is shorter than the specified length, the function pads the String with 
spaces on the right side. 

[0363] If the left-justified String is longer than the specified length, the function returns a null value. 
35 String justifyLeft(String, Integer) 
[0364] 



Parameter Type 


Value 


(String, Integer) 


String to left justify, length of the String to return 


Return Type 


Value 


String 


Resulting String, or a null value 



[0365] The following function creates a String object of the length indicated by an Integer object and left justifies a 
String object within it. If the left-justified String is shorter than the specified length, the function pads the String on the 
50 right side with characters specified in another String. 

[0366] If the left-justified String is longer than the specified length, the function returns a null value. 



55 
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String justifyLeft(String,lnteger,String) 
[0367] 



Parameter Type 


Value 


(String, Integer.String) 


String to left justify, length of the String to return, and character to use to pad the String~~ 


Return Type 


Value 


String 


Resulting String, or a null value 



10 



15 



20 



25 



Example: 

[0368] A message item named Name is defined as a String object. For another message, the user need the value 
of Name, left justified in a String object of length 20, and padded if necessary with spaces. The user would enter the 
function as follows: 

JustifyLeft (MsgDef.Name, 20, "*") 

If the value of Name were Tranz Shubert", the function would return a String object whose value is "Franz Shubert". 
justjfyRight 



[0369] There are two versions of this function. 

[0370] The following function creates a String object of the length indicated by an Integer object and right justifies 
a String object within it. If the right-justified String is shorter than the specified length, the function pads the String with 
spaces on the left side. 

30 [0371] If the right-justified String is longer than the specified length, the function returns a null value. 
String justifyRight(String,lnteger) 
[0372] 

35 



40 



Parameter Type 


Value 


(String, Integer) 


String to right justify, length of the String to return 


Return Type 


Value 


String 


Resulting String, or a null value 



45 [0373] The following function creates a String object of the length indicated by an Integer object and right justifies 
a String object within it. If the right-justified String is shorter than the specified length, the function pads the String on 
the left side with characters specified in another String. 

[0374] If the right-justified String is longer than the specified length, the function returns a null value. 



50 



55 
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String justifyRight(String,lnteger,String) 
[0375] 

5 



Parameter Type 


Value 


(String, Integer.String) 


String to right justify, length of the String to return, and character to use to pad the String 


Return Type 


Value 


String 


Resulting String, or a null value 



Example: 

15 

[0376] A message item named Name is defined as a String object. For another message, the user need the value 
of Name, right justified in a String object of length 20, and padded if necessary with asterisks (*). The user would enter 
the function as follows: 

20 JustifyRight (MsgDef.Name, 20, "") 

If the value of Name were "Sergei Rachmaninoff, the function would return a String object whose value is "'Sergei 
Rachmaninoff. 

25 longToBigPecimal 

[0377] This function converts a Long object to a Big Decimal object. 

BigDecimal longToBigDecimal(Long) 

30 

[0378] 



Parameter Type 


Value 


(Long) 


Long to convert 


Return Type 


Value 


BigDecimal 


Resulting BigDecimal 



longToBoolean 

[0379] This function converts a Long object to a Boolean object. 

45 



50 



55 



45 
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Boolean longToBoolean(Long) 
[0380] 



Parameter Type 


Value 


(Long) 


Long to convert 


ReturnType 


Value 


When 


Boolean 


True 
False 


Long is any value other than 0 
Long is 0 



15 

lonqToDouble 

[0381] This function converts a Long object to a Double object. 
20 Double longToDouble(Long) 
[0382] 



Parameter Type 


Value 


(Long) 


Long to convert 


Return Type 


Value 


Double 


Resulting Double 



lonaToString 

35 [0383] There are two versions of this function. 

[0384] The following function converts a Long object to a String object. 

String longToString(Long) 

40 [0385] 



45 



50 



Parameter Type 


Value 


(Long) 


Long to convert 


Return Type 


Value 


String 


Resulting String 



[0386] The following function converts a Long object to a String object, using a format mask to format the String 
object. * 



55 
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String longToString(Long, String) 
[0387] 

5 



Parameter Type 


Value 


(Long.String) 


Long to convert, format mask 


Return Type 


Value 


String 


Resulting String, in the format specified by the mask 



Example: 

15 

[0388] A message item named CustID is defined as a Long object. For another message, the user need the value 
of CustID in a String object, in the format ##,###. The user would enter the function as follows: 

longToString (MsgDef.CustID, "##,###") 

20 

If the value of CustID were 10321 , the function would return a String object whose value is "10,321". 
lookup 

25 [0389] There are two versions of this function. 

[0390] The following function looks up a String object in a lookup table specified in another String object and returns 
the corresponding value. If the function does not find a corresponding value in the lookup table, it returns a null value. 

String lookup(String, String) 

30 

[0391] 



Parameter Type 


Value 


(String, String) 


String to look up, lookup table 


Return Type 


Value 


String 


Value found in the lookup table, or a null value 



[0392] The following function looks up a String object in a lookup table specified in another String object and returns 
the corresponding value. If the function does not find a corresponding value in the lookup table, it returns a default value 
specified in a third String object. 

45 

String lookup(String,String f String) 
[0393] 

50 



Parameter Type 


Value 


(String.String.String) 


String to look up, lookup table, default value 


Return Type 


Value 


String 


Value found in the lookup table, or the default value 



47 



Example: 
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[0394] A message item named State is defined as a String object. State always contains a two-letter abbreviation 
for the name of one of three states in the United States. For another message, the user need the full name of the state 
5 in a String object. If no full name corresponds to the abbreviation, the user want the String object to contain "N/A" The 
user would enter the function as follows: 

lookup (MsgDef.State, "MD=Maryland, PA=Pennsylvania, VA=Virginia", "N/A") 

10 If the value of State were "VA", the function would return a String object whose value is "Virginia". 

lowercase 

[0395] This function converts all characters in a String object to lowercase. 

15 

String lowercase(String) 



[0396] 

20 



Parameter Type 


Value 


(String) 


String to convert 


Return Type 


Value 


String 


Resulting String 



replaceString 

30 

[0397] This function searches a String object for a particular String object, replaces the found String object with a 

replacement String object, and returns the String object with the replacement String in place. 

[0398] If the function cannot find the String to replace, it returns the String it searched without changing it. 

35 String replaceString(String,String,String) 

[0399] 



40 



Parameter Type 


Value 


(String, String.String) 


String to replace, replacement String, String to search 


Return Type 


Value 


String 


String with replacement String in place 



Example: 

[0400] A message item named Address is defined as a String object. For addresses in the state of Virginia, the 
value in Address sometimes includes the two-letter abbreviation VA. For another message, the user need a String 
object that contains the value of Address, but with the full name of the state substituted for the abbreviation. The user 
would enter the function as follows: 

replaceString ("VA", "Virginia, MsgDef.Address) 

If the value of Address were "Reston, VA 20191", the function would return a String object whose value is "Reston Vir- 
ginia 20191". 



48 



replace Word 
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[0401] This function searches a String object for a particular word, replaces the found word with another word, and 
returns the String object with the replacement word in place. 
5 [0402] The function can only find the specified word within the String object if the word is: (1 ) preceded and followed 
by white space; (2) left justified within the String object and and followed by white space; and (3) right justified within the 
String object and preceded by white space. If the function cannot find the word, it returns the String it searched without 
changing it. 

w String replaceWord(String, String, String) 
[0403] 



15 



Parameter Type 


Value 


(String.String.String) 


Word to replace, replacement word, String to search 


Return Type 


Value 


String 


String with replacement word in place 



Example: 

25 [0404] A message item named Address is defined as a String object. For addresses in the state of Maryland, the 
value in Address sometimes includes the two-letter abbreviation MD. For another message, the user need a String 
object that contains the value of Address, but with the full name of the state substituted for the abbreviation. The user 
would enter the function as follows: 

30 replaceWord ("MD", "Maryland", MsgDef.Address) 

If the value of Address were "Bethesda, MD 20904", the function would return a String object whose value is "Bethesda, 
Maryland 20904". 

35 sizeOf 

[0405] There are two versions of this function. 

[0406] The following function determines the size of a String object and returns the size as a Long object. 
40 Long sizeOf(String) 
[0407] 



45 



Parameter Type 


Value 


(String) 


String whose size to determine 


Return Type 


Value 


Long 


Size of the String 



[0408] The following function determines the size of a ByteArray object and returns the size as a Long object. 

55 



49 



EP 1 016 989 A2 

Long sizeOf(ByteArray) 
[0409] 



Parameter Type 


Value 


(ByteArray) 


ByteArray whose size to determine 


Return Type 


Value 


Long 


Size of the ByteArray 



strinaToBiqDecimal 

15 

[0410] This function converts a String object to a Big Decimal object. 
BigDecimal stringToBigDecimalString) 
20 [0411] 



Parameter Type 


Value 


(String) 


String to convert 


Return Type 


Value 


BigDecimal 


Resulting BigDecimal 



30 

stringToBoolean 

[0412] This function converts a String object to a Boolean object. 
35 Boolean stringToBoolean(String) 
[0413] 



Parameter Type 


Value 


(String) 


String to convert 


Return Type 


Value 


Boolean 


Resulting Boolean 



strinoToCalendar 

50 [0414] There are two versions of this function. 

[0415] The following function converts a String object to a Calendar object. 



50 
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i » 

stringToCalendar(String) 
[0416] 

5 



Parameter Type 


Value 


(String) 


String to convert 


Return Type 


Value 


Calendar 


Resulting Calendar 



[0417] The following function converts a String object to a Calendar object, using a format mask to interpret the 
15 String object. 

Calendar stringToCalendar(String, String) 

[0418] 

20 



Parameter Type 


Value 


(String.String) 


String to convert, format mask 


Return Type 


Value 


Calendar 


Resulting Calendar 



30 Example: 

[0419] A message item named DatePurchased is defined as a String object that contains a date in the format 
M/d/yy. For another message, the user need the Calendar equivalent of the value of DatePurchased in a Calendar 
object. The user would enter the function as follows: 

35 

stringToCalendar (MsgDef.DatePurchased, "M/d/yy") 

If the value of DatePurchased were "2/1 3/00", the function would return a Calendar object whose value is the equivalent 
of February 13, 2000. 

40 

stringToDouble 

[0420] There are two versions of this function. 

[0421] The following function converts a String object to a Double object. 

45 

Double stringToDoubte(String) 
[0422] 

50 



Parameter Type 


Value 


(String) 


String to convert 


Return Type 


Value 


Double 


Resulting Double 
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[0423] The following function converts a String object to a Double object, using a format mask to interpret the String 
object. 



Double stringToDouble(String,String) 
[0424] 



Parameter Type 


Value 


(String, String) 


String to convert, format mask 


Return Type 


Value 


Double 


Resulting Double 



Example: 

[0425] A message item named TotalCost is defined as a String object that contains a dollar amount in the format 
20 ##,###.##. For another message, the user need the value of TotalCost in a Double object. The user would enter the 
function as follows: 

stringToDouble (MsgDef.Totalcost, "##,###.##") 
25 If the value of TotalCost were "5,137.29", the function would return a Double object whose value is 5137.29. 
strinoTolnteger 

[0426] There are two versions of this function. 
30 [0427] The following function converts a String object to an Integer object. 

Integer stringTolnteger(String) 

[0428] 



Parameter Type 


Value 


(String) 


String to convert 


Return Type 


Value 


Integer 


Resulting Integer 



[0429] The following function converts a String object to an Integer object, using a format mask to interpret the 
String object. 
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Integer stringTolnteger(String, String) 
[0430] 



Parameter Type 


Value 


(String, String) 


String to convert, format mask 


Return Type 


Value 


Integer 


Resulting Integer 



Example: 

15 

[0431] A message item named Quantity is defined as a String object that contains an amount in the format #,###. 
For another message, the user need the value of Quantity in a String object. The user would enter the function as fol- 
lows: 

20 stringTolnteger (MsgDef.Quantity, ,, #,###") 

If the value of Quantity were "2,540", the function would return an Integer object whose value is 2540. 
StringToLpng 

25 

[0432] There are two versions of this function. 

[0433] The following function converts a String object to a Long object. 
Long stringToLong(String) 

30 

[0434] 



Parameter Type 


Value 


(String) 


String to convert 


Return Type 


Value 


Long 


Resulting Long 



[0435] The following function converts a String object to a Long object, using a format mask to interpret the String 
object. 

45 Long stringToLong(String, String) 
[0436] 



Parameter Type 


Value 


(String, String) 


String to convert, format mask 


Return Type 


Value 


Long 


Resulting Long 
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Example: 

[0437] A message item named CustID is defined as a String object that contains a number in the format ##,###. 
For another message, the user need the value of CustID in a Long object. The user would enter the function as follows- 

5 

stringToLong (MsgDef.CustID, "##,###") 
If the value of CustID were "10,321", the function would return a Long object whose value is 10321 . 
w subarray 

[0438] This function finds a ByteArray object within another ByteArray object and returns the found ByteArray 
object. 

[0439] If the function cannot find the ByteArray, it returns a null value. 

15 

ByteArray subarray(Long,Long,ByteArray) 
[0440] 



Parameter Type 


Value 


(Long.Long, ByteArray) 


Position of the first byte of the ByteArray to find, position of the last byte of the ByteArray 
to find, ByteArray that contains the ByteArray to find; positions start with 0 


Return Type 


Value 


ByteArray 


ByteArray that has been found 



[0441] Example A message item named Array is defined as a ByteArray object. For another message, the user 
need the first eight bytes of Array in a ByteArray object. The user would enter the function as follows: 



subArray (0, 7, MsgDef.Array) 
35 substring 

[0442] This function finds a String object within another String object and returns the found String object. 
[0443] If the function cannot find the String, it returns a null value. 

40 String substring(Long,Long,String) 

[0444] 



45 



Parameter Type 


Value 


(Long.Long.String) 


Position of the first character of the String to find, position of the last character of the String to 
find, String that contains the String to find 


Return Type 


Value 


String 


String that has been found 



trim 

55 

[0445] This function removes white space before and after a String object. 
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String trim(String) 
[0446] 

5 



Parameter Type 


Value 


(String) 


String object from which to remove white space 


Return Type 


Value 


String 


Resulting String 



uppercase 

75 

[0447] This function converts all characters in a String object to uppercase. 
String uppercase(String) 
20 [0448] 



Parameter Type 


Value 


(String) 


String to convert 


Return Type 


Value 


String 


Resulting String 



30 

[0449] The examples shown and described herein above are not meant to limit the scope of the invention. Accord- 
ingly, modifications and variations according to the present invention will become apparent to those of ordinary skill in 
the art, without departing from the spirit and scope of the appended claims. 

35 Claims 

1. A system for integrating a plurality of computer applications, comprising: 

an enterprise messaging system, said enterprise messaging system passing messages between said compu- 
40 ter applications; 

a database storage system coupled to said enterprise messaging system, said database storage system stor- 
ing a plurality of data transformation configurations and a plurality of rules; 

an integration service coupled to said enterprise messaging system, said integration server comprising a data 
transformation engine using the data transformation configurations stored in said database storage system 
45 and a rules evaluation engine using the rules stored in said database storage system; 

a plurality of agent-adapters coupled to said enterprise messaging system, each agent-adapter coupled to a 
respective one of said computer applications, each agent-adapter passing messages between said enterprise 
messaging system and said respective computer application; and 

a message schema operating in conjunction with said agent-adapters to parse individual message elements 
so from the computer applications. 

2. The system according to claim 1 , wherein said integration service system splits and combines messages received 
from said enterprise messaging system and performs content-based routing of messages to said computer appli- 
cations. 

55 

3. The system according to claim 1 , wherein each said agent-adapter translates messages being passed from said 
enterprise messaging system to said respective computer application from a system format to a respective compu- 
ter application format, and translates messages being passed from said respective computer application to said 
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enterprise messaging system from the respective computer application format to the system format. 

4. The system according to claim 1, wherein each said agent-adapter further passes messages between other said 
agent-adapters and said respective computer application. 

5. The system according to claim 1 , wherein each said agent-adapter comprises an adapter portion and an agent por- 
tion encapsulating said adapter portion. 

6. The system according to claim 1, wherein each said agent-adapter comprises one or more adapter portions and 
an agent portion encapsulating all of said one or more adapter portions. 

7. An improved enterprise application integration system including an agent-adapter for use therein, the improvement 
comprising: 

an adapter configured for a selected one of the enterprise applications; 
an agent service hosting said adapter; 

a message definition for each of a plurality of messages said adapter will produce, receive, or reply to; 
means for connecting said adapter to said selected enterprise application; and 
means for implementing said adapter through said connecting means. 

8. The improvement according to claim 7, wherein said adapter is selected from the group consisting of a source 
adapter, a target adapter, a reply adapter, and a request adapter. 

9. A method for passing messages between a first computer application and a second computer application, compris- 
ing the steps of: 

providing a first message having a first data from said first computer application; 
publishing said first message to obtain a first published message; 

converting said first data of said first published message to a second data to obtain a second message; 
publishing said second message to obtain a second published message; and 
providing said second published message to said second computer application. 

10. The method according to claim 9, further comprising the steps of: 

translating said first message from a first computer application format to a system format prior to publishing 
said first message; and 

translating said second published message from said system format to a second computer application format 
prior to providing said second published message to said second computer application. 

11. The method according to 9, wherein said step of converting said first data comprises: 

requesting said second data from a database; and 
receiving said second data from said database. 

12. An agent-adapter for use in an enterprise application integration system, which integrates a plurality of enterprise 
applications, comprising: 

an adapter configured for a selected one of the enterprise applications; 
an agent service hosting said adapter; 

a message definition for each of a plurality of messages said adapter will produce, receive, or reply to; 
means for connecting said adapter to said selected enterprise application; and 
means for implementing said adapter through said connecting means. 

13. The agent-adapter according to claim 12, wherein said adapter is selected from the group consisting of a source 
adapter, a target adapter, a reply adapter, and a request adapter. 

14. The agent-adapter according to claim 13, wherein said adapter comprises a source adapter and further comprising 
means for designating selected ones of a plurality of targets said source adapter is adapted to send one or more 
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messages. 

15. The agent-adapter according to claim 13, wherein said adapter comprises a target adapter and further comprising 
means for designating selected ones of a plurality of sources from which said target adapter is adapted to receive 

5 one or more messages. 

16. The agent-adapter according to claim 13, wherein said adapter comprises a reply adapter and further comprising 
means for designating selected ones of a plurality of requesters to which said reply adapter is adapted to send one 
or more reply messages. 

10 

17. A method for passing messages between a first computer application and a second computer application, compris- 
ing the steps of: 

providing a first message having a first data from said first computer application; 
15 publishing said first message to obtain a first published message; 

converting said first data of said first published message to a second data to obtain a second message; 
publishing said second message to obtain a second published message; and 
providing said second published message to said second computer application. 

20 18. The method according to claim 17, further comprising the steps of: 

translating said first message from a first computer application format to a system format prior to publishing 
said first message; and 

translating said second published message from said system format to a second computer application format 
25 prior to providing said second published message to said second computer application. 

19. The method according to 18, wherein said step of converting said first data comprises: 

requesting said second data from a database; and 
30 receiving said second data from said database. 

20. The method according to claim 19, further comprising the steps of: 

providing an adapter configured for a selected one of said computer applications; 
35 providing an agent service to host said adapter; 

defining a message definition for each of a plurality of messages said adapter will produce, receive, or reply to; 
and 

connecting said adapter to selected computer application. 

40 21. In an enterprise application integration system that integrates a plurality of enterprise applications, each of which 
have a respective native format for creating, sending, receiving, storing, and processing a plurality of messages, 
the improvement comprising: 

an agent-adapter including a plurality of adapters encapsulated by an agent; 

wherein each of said plurality of adapters encapsulated by said agent includes means for performing a discrete 
function while encapsulated by said agent. 

The improvement according to claim 21, wherein said agent further comprises a plurality of objects embedded 
therein, each of said plurality of objects adapted to perform a discrete function. 

The improvement according to claim 22, wherein a first of said plurality of objects embedded in said agent further 
comprises means for managing connections of said agent-adapter between selected ones of the plurality of enter- 
prise applications and the system. 

The improvement according to claim 23, wherein a second of said plurality of objects embedded in said agent fur- 
ther comprises means for managing errors detected in said agent-adapter between selected ones of the plurality 
of enterprise applications and the system. 



45 
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22. 



23. 
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25. The improvement according to claim 23, wherein a third of said plurality of objects embedded in said agent further 

COmDriSeS means fnr mananinn a tran<ifr>rmatinn nf tho nlnralih/ nf moccanoc wuithin coin 1 ononLarlonfor he»t»*#ckor> 
- c» o - i / a — ~3 r w~*,.v^. , 

selected ones of the plurality of enterprise applications and the system. 

26. The improvement according to claim 22, further comprising a plurality of nodes and a plurality of system services 
resident on said nodes. 

27. The improvement according to claim 26, wherein said agent further comprises a plurality of objects embedded 
therein, each of said plurality of objects adapted to perform a discrete function. 

28. The improvement according to claim 27, wherein each of said plurality of objects embedded in said agent is 
adapted to perform its respective function at any one of said plurality of nodes. 

29. The improvement according to claim 27, wherein each of said plurality of objects embedded in said agent is 
adapted to perform its respective function in conjunction with respective ones of said objects embedded in another 
agent in the system. 

30. A system for integrating a plurality of computer applications, comprising: 

an enterprise messaging system, said enterprise messaging system passing messages between said compu- 
ter applications; 

a database storage system coupled to said enterprise messaging system, said database storage system stor- 
ing a plurality of data transformation configurations and a plurality of rules; 

an integration service coupled to said enterprise messaging system, said integration server comprising a data 
transformation engine using the data transformation configurations stored in said database storage system 
and a rules evaluation engine using the rules stored in said database storage system; and 
a plurality of agent-adapters coupled to said enterprise messaging system, each agent-adapter coupled to a 
respective one of said computer applications, each agent-adapter passing messages between said enterprise 
messaging system and said respective computer application. 

31. The system according to claim 30, further comprising: 

a message schema, including a plurality of message elements; 

a plurality of accessors, each of which is adapted for a selected one of said computer applications; and 

a plurality of converters, each of which is adapted for a selected one of said computer applications and adapted 

to be coupled to selected ones of said plurality of accessors; 

wherein selected ones of said plurality of message elements corresponding to one of said computer applica- 
tions are adapted to be accessed and converted for communication with another of said computer applications. 

32. The system according to claim 31, wherein said plurality of accessors and said plurality of converters are distrib- 
uted throughout the system. 
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